You are viewing the Spanish (Mexico) site, but your language preference is set to English. Switch to English site →

Menu

Expand
Calificar esta página:

Subrecurso de invitaciones

Este producto de Twilio está actualmente disponible como una versión beta. Algunas funciones aún no están implementadas y otras podrían cambiar antes de que se declare que el producto está disponible en general. El uso de esta versión beta está sujeto a los términos pertinentes del acuerdo de licencia aplicable. Los productos en versión beta no están cubiertos por un SLA de Twilio. Obtén más información sobre el soporte de productos en versión beta.

Flex Conversations requiere Flex UI 2.0. Si utilizas Flex UI 1.x, consulta las páginas de mensajería en Flex.

El subrecurso de canal de interacción permite agregar un agente como nuevo participante a un canal de interacción existente.

/Interactions/<interaction_sid>/Channels/<channel_sid>/Invites

Utiliza este punto final para realizar las siguientes acciones:

La invitación crea una nueva tarea en la interacción existente, que dará como resultado reservas ofrecidas a los agentes.

Remember to handle certain terminal TaskRouter events according to you application's needs, as conversations may stay orphaned with an open state.

See Conversations Best Practices for details.

Propiedades de la invitación del canal de interacción

Parámetro Subcampo Descripción

Routing [obligatorio]

Un objeto JSON que representa las reglas de enrutamiento del canal de interacción. Consulta el ejemplo de mensaje SMS saliente para ver un ejemplo del objeto Routing. El recurso de interacciones utiliza TaskRouter para toda la funcionalidad de enrutamiento.

properties [obligatorio]

Campos necesarios para crear una tarea:

workspace_sid [obligatorio] El SID del espacio de trabajo de TaskRouter que comienza con WS.

workflow_sid [opcional] El SID del flujo de trabajo con el prefijo WW. Es opcional si solo hay un flujo de trabajo definido; de lo contrario, es obligatorio.

queue_sid [obligatorio para interacciones iniciadas por el agente]. El SID de cola de TaskRouter con el prefijo WQ.

worker_sid [obligatorio para interacciones iniciadas por el agente]

task_channel_sid [opcional]

task_channel_unique_name [opcional]

attributes [opcional]: los atributos de tarea.

priority [opcional]: la prioridad de la tarea en la cola.

timeout [opcional]: el intervalo de tiempo de espera de la tarea o reserva en segundos.


Todos los atributos del objeto Routing en el cuerpo de la solicitud de interacción se agregan “tal cual” a la tarea. Para obtener una lista de los atributos conocidos consumidos por Flex UI (la interfaz de usuario de Flex) o Flex Insights, consulta Atributos de tarea conocidos.



Resource Properties in REST API format
sid
sid<KG> Not PII

La cadena única creada por Twilio para identificar un recurso de invitación de canal de interacción.

interaction_sid
sid<KD> Not PII

El SID de la interacción de este canal.

channel_sid
sid<UO> Not PII

El SID del canal de esta invitación.

routing
object Not PII

Un objeto JSON que representa las reglas de enrutamiento del canal de interacción. Consulta el ejemplo de mensaje SMS saliente para ver un ejemplo del objeto Routing. El recurso de interacciones utiliza TaskRouter para toda la funcionalidad de enrutamiento. Todos los atributos del objeto Routing en el cuerpo de la solicitud de interacción se agregan “tal cual” a la tarea. Para obtener una lista de los atributos conocidos consumidos por Flex UI (la interfaz de usuario de Flex) o Flex Insights, consulta Atributos de tarea conocidos.

url
url Not PII

Crear una invitación de canal de interacción

post
https://flex-api.twilio.com/v1/Interactions/{InteractionSid}/Channels/{ChannelSid}/Invites
Parameters
Parameters in REST API format
interaction_sid
Path
post sid<KD> Not PII

El SID de la interacción de este canal.

channel_sid
Path
post sid<UO> Not PII

El SID del canal de esta invitación.

routing
Required
post object Not PII

La lógica de enrutamiento de la interacción.

Example 1
        
        
        
        En esta solicitud de ejemplo, se invita a un agente al canal de una interacción.

        Invitar a un agente

        En esta solicitud de ejemplo, se invita a un agente al canal de una interacción.
        {
           "url": "https://flex-api.twilio.com/v1/Interactions/KDXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Channels/UOXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Invites/KGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
           "interaction_sid": "KDXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
           "channel_sid": "UOXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
           "routing": {
               "reservation": null,
               "properties": {
                   "date_updated": 1636401979,
                   "age_in_queue": 0,
                   "task_channel_unique_name": "default",
                   "assignment_status": "pending",
                   "queue_name": "Sample Queue",
                   "assignmentCounter": 0,
                   "priority": 0,
                   "sid": "WTXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
                   "task_queue_entered_date": 1636401979,
                   "workflow_name": "Default Fifo Workflow",
                   "workflow_sid": "WWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
                   "routing_target": "WKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
                   "reason": null,
                   "attributes": "{\"flexChannelInviteSid\":\"KGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\"conversationSid\":\"UOXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\"channelType\":\"email\",\"conversations\":{\"communication_channel\":\"Email\",\"conversation_id\":\"KDXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\"media\":[{\"conversation_sid\":\"UOXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\"media\":[{\"type\":\"ChatTranscript\",\"sid\":\"CHXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"}],\"customers\":{\"phone\":null,\"name\":null,\"email\":null}},\"flexInteractionChannelSid\":\"UOXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\"flexInteractionSid\":\"KDXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"}",
                   "task_channel_sid": "TCXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
                   "age": 0,
                   "workspace_sid": "WSXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
                   "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
                   "timeout": 86400,
                   "date_created": 1636401979,
                   "addons": "{}",
                   "queue_sid": "WQXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
               }
           },
           "sid": "KGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
        }
        Calificar esta página:

        ¿Necesitas ayuda?

        Todos la necesitamos a veces; la programación es difícil. Obtén ayuda ahora de nuestro equipo de soporte, o recurre a la sabiduría de la multitud visitando Stack Overflow Collective de Twilio o navegando por la etiqueta de Twilio en Stack Overflow.

              
              
              

              Gracias por tus comentarios.

              Selecciona los motivos de tus comentarios. La información adicional que nos brindas nos ayuda a mejorar nuestra documentación:

              Enviando tus comentarios…
              🎉 Gracias por tus comentarios.
              Se produjo un error. Inténtalo de nuevo.

              Gracias por tus comentarios.

              thanks-feedback-gif