Los agentes IA hacen solicitudes HTTP de servidor a servidor al sistema backend. Las solicitudes se inician cuando una ruta de usuario gatilla un nodo de integración en su diálogo, y los datos devueltos mapeados se almacenan mientras dura la sesión de los agentes IA (y están disponibles todo ese tiempo).
Requisitos técnicos aplicables a la API del sistema backend
Tipos de API
Para la API solo se admiten estas dos arquitecturas:
- REST
- GraphQL
Respuesta
La respuesta de la API debe obtenerse:
- En 30 segundos como máximo
- Preferiblemente, en formato JSON
Autenticación
En lo que respecta a los agentes IA, se admiten los siguientes métodos de autenticación:
- Clave de API
- Token de portador
- Token de vencimiento
- Autenticación básica
- OAuth 2.0
- Listas seguras o autorizadas de IP
Lista de autocomprobación
La siguiente lista de autocomprobación contiene preguntas e información útiles para crear una API sólida:
- ¿Funciona la búsqueda de la API con datos que conocería un usuario común o con datos provenientes de la plataforma de CRM?
- En la respuesta de la API, ¿contienen los datos información útil para su caso de uso?
- Si para su caso de uso se necesitan datos de varios sistemas, ¿puede consolidarlos en una capa intermedia?
- Cuando la API devuelve un código de estado HTTP 200, 400 y 404 HTTP, ¿se tiene noticia de ello?
- ¿Qué devuelve la API si los datos introducidos no son válidos o son incorrectos?
- ¿Define su sistema un límite de procesamiento de API?
- ¿Cuánto tarda el sistema en enviar una respuesta?
Tenga listo lo siguiente:
• Documentación relativa a la autenticación, las consultas y el cuerpo de las solicitudes realizadas a la API y el esquema de respuesta.
• Una colección Postman (solo si lo desea).
• Datos de prueba para los resultados más comunes.
En el artículo de preparativos para crear una integración personalizada encontrará información más detallada sobre el plan de puesta en marcha.