Este componente permite realizar solicitudes a APIs externas, facilitando la comunicación en tiempo real entre Atom y otros sistemas (CRMs, bases de datos o servicios en la nube).
🎯 Propósito y utilidad
Conectar Atom con plataformas externas mediante protocolos estándar.
Enviar y recibir datos durante la conversación (ej. consultar un saldo o registrar un lead).
Integración total: Automatizar procesos consultando fuentes de datos propias de la empresa.
⚙️ Configuración básica
Métodos disponibles: Soporta los verbos estándar HTTP: GET, POST, PUT, DELETE, PATCH y HEAD.
URL: Dirección del endpoint al que se realiza la petición.
Botón de probar petición: Permite verificar si la conexión es exitosa o denegada antes de publicar el flujo.
Cuerpo de la petición (Body): Permite enviar datos únicamente en formato JSON. El editor integrado indica si existen errores de sintaxis en el código y permite insertar parámetros dinámicos fácilmente.
Encabezados (Headers): Sección con presets listos para usar (como Authorization, Content-Type o Accept). Por seguridad, los valores sensibles como tokens se muestran ofuscados.
🛠️ Configuraciones Avanzadas
Autorización
Permite configurar el tipo de credenciales que requiere la API, con soporte nativo para OAuth 2.0 o Basic Auth.
Guardar Respuesta
Tras realizar una prueba exitosa, el JSON de respuesta aparece precargado. Solo debes hacer clic en el dato que necesitas y Atom completará la ruta (path) automáticamente. Puedes guardar valores específicos o la respuesta completa en:
Campos de información (perfil del cliente).
Variables de flujo (uso temporal durante la sesión).
📌 Ejemplo de uso: Si la API devuelve:
{ "data": { "estado": "En camino" } }
Puedes vincular "data.estado" a la variable "ESTADO_ORDEN" para almacenarla y usarla en un mensaje posterior: "Tu pedido está actualmente: {{ESTADO_ORDEN}}"
Manejo de códigos de respuesta
Puedes definir rutas lógicas en el flujo según el resultado de la petición:
Éxito: (Códigos 200, 201). Continúa el flujo positivo.
Error: (Códigos 400, 500). Deriva a un mensaje de disculpa o a un agente.
Reintento: Para errores temporales (como el 429 o timeouts). Permite configurar hasta 5 intentos automáticos antes de dar la petición por fallida.
Tiempo de espera (Timeout)
Define el tiempo máximo en segundos que Atom esperará la respuesta de tu servidor. El límite máximo permitido es de 60 segundos.
✅ Checklist de integración
¿La URL es accesible desde internet?
¿Los encabezados de autorización están vigentes?
¿El formato del cuerpo (JSON) es válido?
¿Has configurado una salida para los códigos de error (400/500)?
¡Tus bots ahora son más inteligentes! 🚀
Al dominar la Petición HTTP, puedes conectar Atom con cualquier plataforma y consultar datos al instante. Automatiza procesos avanzados, elimina tareas manuales y brinda respuestas precisas a tus clientes. ✅