Integraciones personalizadas

Nathan Begbie Actualizado por Nathan Begbie

¿Por qué utilizar una integración personalizada?

Las integraciones personalizadas pueden mejorar su experiencia de soporte técnico al vincular su servicio Turn a sistemas externos como el sistema de gestión de relaciones con el cliente, su base de datos de pacientes o cualquier servicio externo que esté ejecutando.

¿Qué puede hacer con las integraciones personalizadas?

  • Acciones: permitir a los operadores del servicio de soporte técnico activar webhooks externos para un mensaje determinado
  • Respuestas sugeridas: dado el historial de mensajes con un mensaje determinado paciente, genere una respuesta sugerida que un operador del servicio de asistencia técnica pueda elegir utilizar
  • Contexto adicional: obtenga datos adicionales y muéstrelos en la barra lateral de su aplicación. Esto es particularmente útil si desea almacenar datos de contacto adicionales en un almacén de datos separado.

Configuración de la integración personalizada

Primero, navegue hasta "Configuración" y luego haga clic en el botón "Integraciones" y luego, en el botón desplegable "Agregar una integración", seleccione "Integración personalizada"

En este punto debes proporcionar un par de campos:

Nombre: cómo identificará la integración relevante.

URL: este es el punto final en el que se encuentra su integración personalizada. llamará con varias cargas útiles JSON. Su servicio solo puede recibir cargas útiles en este único punto final.

Tipo de autenticación HTTP y Token API: estas características son necesarias al configurar una integración personalizada con Turn.io, pero se relacionan específicamente con cómo funciona su servicio. El Tipo de autorización HTTP puede ser BEARER o TOKEN. Esto solo significa que, digamos, por ejemplo, que eliges BEARER y configuras el API Token en 123, cada vez que Turn realice una solicitud a tu servicio, incluirá el encabezado HTTP Autorización: Portador 123 en cada llamada. Esto significa que puede estar seguro de que el servicio puede verificar que las solicitudes provienen de Turn. Sin embargo, si recién está probando esta funcionalidad y no desea implementar ninguna autenticación en su aplicación, no tiene que preocuparse por lo que selecciona o ingresa en estos campos (pero deberá ingresar algo).

Una vez que seleccione "Crear integración", Turn.io intentará enviar un protocolo de enlace al servicio que acaba de crear. Si aún no has configurado nada, está bien. El apretón de manos fallará. Una vez que haya configurado su servicio, puede intentar volver a habilitar

Implementación de su integración personalizada

Siempre que pueda configurar un servicio que pueda recibir llamadas HTTP, puede integrarse con cualquier servicio que desee. Sin embargo, proporcionamos algunos kits de inicio y ejemplos en Javascript y Python

Uso de la biblioteca de integración Turn Javascript

Una de las formas en que puede crear una biblioteca de integración personalizada es utilizando el paquete Turn npm. La biblioteca requiere que le proporciones el SECRET que Turn genera cuando crea la integración. Utiliza este secreto para autenticar las llamadas de Turn.

A continuación encontrará un desglose muy detallado de las llamadas y respuestas que están disponibles para usted. se proporciona en la documentación del desarrollador, que recomendamos encarecidamente leer.

Si desea intentar crear su propia integración personalizada utilizando la biblioteca Javascript, utilice el Repl.it prediseñado que hemos configurado para usted.

Otros ejemplos en Python

Hay una serie de repositorios que hemos creado como ejemplos para probar. salir y experimentar. Son ejemplos listos para ejecutar con Repl.it Haga clic aquí para verlos todos.

Si desea ver algunas de las funciones disponibles con integraciones personalizadas, puede utilizar algunos ejemplos de plantillas como punto de partida con:

turnio-duckduckgo-replit: un ejemplo de integración de respuesta sugerida por Turn.io en Replit. Esto devolverá el resumen de la API DuckDuckGo como una respuesta sugerida en la interfaz de usuario de Turn.io

turnio-integration-replit: un ejemplo de integración de la interfaz de usuario de Turn.io en Replit. Esto amplía la interfaz de usuario de Turn con una respuesta rápida, información de perfil personalizada y menús de acciones.

¿Cómo lo hicimos?

Webhook Troubleshooting

Cómo configurar una integración RapidPro

Contacto