Requisitos Previos
Antes de configurar tus peticiones HTTP, asegúrate de tener lo siguiente listo en tu entorno:
Permisos de Administrador para crear y editar flujos en el Flowbuilder.
Campos personalizados de tipo selector ya creados, con sus opciones debidamente configuradas (tanto el Label visible como su Key interno).
Conocimiento de la estructura de la petición requerida por el servicio externo (Endpoint, Headers y el cuerpo de la petición en formato JSON).
📤 Enviar Datos de un Selector a una API Externa
Cuando recopilas información de un cliente mediante un campo tipo selector y necesitas enviarla a tu CRM u otro sistema mediante el Componente HTTP, es vital elegir qué formato de dato quieres transmitir.
Todo campo selector se compone de dos propiedades:
Propiedad | Definición para el Usuario | Nomenclatura en el Flowbuilder | Ejemplo Práctico |
Label (Etiqueta) | El texto amigable que lee el cliente o el asesor en la interfaz de chat. |
| "Suzuki Swift" |
Key (Valor Interno) | El identificador único del dato, diseñado para ser leído por bases de datos. |
|
|
Para definir qué propiedad enviar en el cuerpo (Body) de tu petición JSON, simplemente agrega un punto (.) seguido de la propiedad al final de la variable de tu campo.
Observa este ejemplo de configuración JSON:
JSON
{
"modelo_enviando_label": "{{client.custom_modelos_suzuki.label}}",
"modelo_enviando_key": "{{client.custom_modelos_suzuki.key}}",
"modelo_comportamiento_defecto": "{{client.custom_modelos_suzuki}}"
}
💡 Tip: Presta atención a la tercera línea del ejemplo. Si colocas la variable sin especificar ninguna terminación, el sistema de Atom enviará siempre el Key (Valor Interno) por defecto.
📥 Guardar la Respuesta de una API en un Selector
Si tu caso de uso es consultar un sistema de terceros (por ejemplo, validar el estatus de un cliente en HubSpot) y deseas almacenar esa respuesta automáticamente dentro de un selector en Atom, sigue esta ruta:
Ingresa al nodo de tu Componente HTTP en el Flowbuilder.
Desplázate hasta la sección de mapeo de respuestas o guardado de variables.
Define la ruta exacta del JSON de respuesta que deseas capturar (ej.
data.status_cliente).Selecciona el campo personalizado tipo selector de Atom donde aterrizará este dato.
⚠️ Importante: Para que el guardado sea exitoso, Atom ejecuta una validación estricta. Primero intentará coincidir la respuesta de la API con el Key de alguna opción. Si no hay éxito, buscará una coincidencia del 100% con el Label (respetando mayúsculas y espacios). Si la respuesta no coincide ni con el Key ni con el Label, el campo no guardará nada para proteger la integridad de tus datos.
🧪 Auditoría y Verificación
Para confirmar que tu estrategia de envío y guardado de datos está funcionando a la perfección, ejecuta el siguiente protocolo de prueba:
Inicia una conversación desde un canal de prueba conectado a tu Flowbuilder y avanza hasta atravesar el nodo del Componente HTTP.
Dirígete a la consola de tu servicio de terceros y verifica que el sistema haya recibido correctamente el Label o el Key, según cómo lo configuraste.
Para validar la recepción de vuelta, abre el Panel Lateral de tu conversación de prueba en Atom. Revisa la pestaña de información del cliente y confirma que el campo selector se actualizó con la nueva opción.
¡Y eso es todo! Ahora tienes el conocimiento técnico para orquestar la comunicación de datos estructurados entre Atom y cualquier ecosistema tecnológico. Al dominar el uso de Labels, Keys y las reglas de validación, garantizas integraciones robustas y mantienes la base de datos de tu plataforma totalmente impecable. ✅