En esta guía se describe cómo configurar un agente de respuesta predeterminado por canal mediante una llamada de API en Sunshine Conversations.
Nota: En esta guía se usa Postman. Si no tiene Postman, regístrese para obtener una cuenta en el sitio web y descargue la aplicación.
Importe la plantilla de API
- Abra el archivo postman_collection.json. La colección está en formato JSON y no es fácilmente legible.
- Seleccione todo el texto y cópielo.
3. Abra Postman y haga clic en Importar.
4. Pegue el contenido del archivo de la colección en el cuadro de texto “Pegar cURL, texto sin formato o URL”.
La colección de API de Sunshine Conversations aparece en la interfaz de Postman.
Seleccione la llamada a la API de PATCH en la lista Colecciones
- En la colección de API de Sunshine Conversations en Postman, seleccione Integración > Actualizar integración.
- Siga los pasos en Obtener una lista de ID de integración a partir de los mensajes para recuperar una lista completa de sus ID de integración y el ID de agente de respuesta predeterminado para los agentes IA.
El ID de agente de respuesta predeterminado es el mismo para todas las integraciones.
- Para la llamada a la API de PATCH, remplace el extremo predeterminado con el ID de la aplicación de la clave de API de Zendesk (la misma que usa para conectarse a Agentes IA – Avanzado) y el ID de integración que desea modificar. En este ejemplo, nos enfocaremos en la integración de iOS para que se pueda lanzar a la web sin el SDK de la aplicación.
- Como se muestra arriba, haga clic en la pestaña Autenticación y seleccione Autenticación básica. Ingrese su ID de clave y Clave secreta, los cuales provienen de la misma información de la API de Zendesk.
- En la pestaña del cuerpo, configure manualmente la integración (iOS) para usar agentes IA con el ID de agente de respuesta predeterminado de los agentes IA (incluso si ya está configurado).
Elimine todo el contenido del cuerpo excepto “defaultResponderId” y agregue el ID que obtuvo de la llamada a la API de la lista de integraciones. Recuerde eliminar las comas superfluas.
- Ejecute la llamada a la API de PATCH y siga con la llamada a la API de GET de la lista de integración para verificar que se haya actualizado correctamente.
Después de hacer el cambio, el canal de iOS sigue usando agentes IA. Sin embargo, el campo “inherited” ahora está establecido en falso, lo que indica que no cambiará automáticamente a Agentes IA – Avanzado cuando este se conecte.
- Conecte Agentes IA – Avanzado al entorno de producción de Zendesk. Observe que solo lo usarán los canales marcados con “inherited = true”.
- Una vez que el cliente decida hacer la transición de canales adicionales a Agentes IA – Avanzado, envíe el valor “null” (sin comillas) al ID de integración del canal deseado. Esta acción revierte el canal a su comportamiento predeterminado, alternando entre Agentes IA – Avanzado y Zendesk según el estado de conexión del primero.
La lista ahora muestra que el canal de iOS usa Agentes IA – Avanzado de nuevo.
Ahora, cada vez que desconecte Agentes IA – Avanzado, todos los canales marcados con un estado heredado (“inherited”) volverán al agente IA, y viceversa. Los canales que se configuraron manualmente con el agente IA lo seguirán usando.
Advertencia: evite establecer manualmente un canal en Agentes IA – Avanzado con la propiedad inherited establecida en falso. Si lo hace, podría evitar la desconexión de Agentes IA – Avanzado de Zendesk. Si tiene problemas con Agentes IA – Avanzado, el agente de respuesta predeterminado se mantendrá en Agentes IA – Avanzado, lo que podría causar que no se responda a los chats.