This component allows you to make requests to external APIs, facilitating real-time communication between Atom and other systems (CRMs, databases, or cloud services).
🎯 Purpose and utility
Connect Atom with external platforms using standard protocols.
Send and receive data during the conversation (e.g., check a balance or register a lead).
Full integration: Automate processes by consulting your company's own data sources.
⚙️ Basic configuration
Available methods: Supports standard HTTP verbs: GET, POST, PUT, DELETE, PATCH, and HEAD.
URL: Address of the endpoint to which the request is made.
Test request button: Allows you to verify if the connection is successful or denied before publishing the flow.
Request body: Allows you to send data only in JSON format. The integrated editor indicates if there are syntax errors in the code and allows you to insert dynamic parameters easily.
Headers: Section with ready-to-use presets (such as Authorization, Content-Type, or Accept). For security, sensitive values like tokens are displayed obfuscated.
🛠️ Advanced configurations
Authorization
Allows you to configure the type of credentials required by the API, with native support for OAuth 2.0 or Basic Auth.
Save response
After a successful test, the response JSON appears preloaded. You just need to click on the data you need and Atom will complete the path automatically. You can save specific values or the entire response to:
Information fields (customer profile).
Flow variables (temporary use during the session).
📌 Example of use: If the API returns:
{ "data": { "estado": "En camino" } }
You can link "data.estado" to the variable "ESTADO_ORDEN" to store it and use it in a later message: "Your order is currently: {{ESTADO_ORDEN}}"
Response code handling
You can define logical routes in the flow based on the result of the request:
Success: (Codes 200, 201). Continue the positive flow.
Error: (Codes 400, 500). Route to an apology message or to an agent.
Retry: For temporary errors (such as 429 or timeouts). Allows you to configure up to 5 automatic attempts before considering the request failed.
Timeout
Define the maximum time in seconds that Atom will wait for your server's response. The maximum allowed limit is 60 seconds.
✅ Integration checklist
Is the URL accessible from the internet?
Are the authorization headers current?
Is the request body format (JSON) valid?
Have you configured an output for error codes (400/500)?
Your bots are now smarter! 🚀
By mastering HTTP requests, you can connect Atom with any platform and consult data instantly. Automate advanced processes, eliminate manual tasks, and provide accurate responses to your customers. ✅