Agentes IA – Avanzado para hacer solicitudes HTTP de servidor a servidor a su sistema de backend. Las solicitudes se inician cuando una ruta de usuario dispara un nodo de integración en su diálogo, y los datos devueltos mapeados se almacenan y están disponibles durante la sesión de Agentes IA – Avanzado.
Requisitos técnicos de la API de backend
Tipos de API
La API debe tener una de las siguientes arquitecturas:
- REST
- GraphQL
Respuesta
La respuesta de la API debe cumplir estos requisitos generales:
- Proporcionar una respuesta de API en 30 segundos
- Preferiblemente devolver formato JSON
Autenticación
En Agentes IA – Avanzado, podemos autenticarnos usando cualquiera de los siguientes:
- Clave API
- Token de portador
- Token de vencimiento
- Autenticación básica
- OAuth 2.0
- Listas de IP seguras/autorizadas
Lista de autoverificación
La lista de autoverificación a continuación contiene preguntas e información que le ayudarán a crear una API sólida:
- ¿Se pueden hacer búsquedas en la API con datos que un usuario típico conocería, o con datos transferidos desde su CRM?
- ¿Los datos de la respuesta de la API contienen información que cumple su caso de uso?
- Si su caso de uso requiere datos de varios sistemas, ¿puede consolidarlos en una capa intermedia?
- ¿Se sabe cuándo la API arroja un código de estado HTTP 200, 400 y 404?
- ¿Qué devuelve la API si la entrada no es válida o es incorrecta?
- ¿Su sistema establece un límite de acceso a las API?
- ¿Cuánto tiempo tarda el sistema en enviar una respuesta?
Esté preparado para proporcionar:
Documentación: Autenticación, consulta de solicitud de API/cuerpo y esquema de respuesta
• (Opcionalmente, una colección de Postman).
• Datos de prueba para los resultados más comunes.
Lea más sobre el plan de integración en el artículo anterior, Integración personalizada: preparación.