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:
- Agregar un agente a una interacción en curso
- Buscar un agente que se debe agregar mediante la evaluación de un flujo de trabajo de TaskRouter
- Enviar una interacción a una cola
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.
|
||
| Resource Properties in REST API format | |
|---|---|
sid
|
La cadena única creada por Twilio para identificar un recurso de invitación de canal de interacción. |
interaction_sid
|
El SID de la interacción de este canal. |
channel_sid
|
El SID del canal de esta invitación. |
routing
|
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
|
|
Crear una invitación de canal de interacción
https://flex-api.twilio.com/v1/Interactions/{InteractionSid}/Channels/{ChannelSid}/Invites
Parameters
| Parameters in REST API format | |
|---|---|
interaction_sid
Path
|
El SID de la interacción de este canal. |
channel_sid
Path
|
El SID del canal de esta invitación. |
routing
Required
|
La lógica de enrutamiento de la interacción. |
Example 1
{
"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"
}¿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.
