Integrations
============

Integration blocks connect the Chatbot flow to external services — HTTP requests, automation platforms, CRM tools, and other OneByZero Neo agent types.

----

.. _chatbot-ref-webhook:

Webhook (HTTP Request)
----------------------

Makes an HTTP request to an external URL. Use it to call APIs, send data to webhooks, or retrieve data from third-party services.

**How to use**

Drag **Webhook** onto the canvas, enter the URL and method, configure headers and body as needed, and map response fields to variables.

**Configuration**

.. list-table::
   :widths: 30 70
   :header-rows: 1

   * - Field
     - Description
   * - URL
     - The endpoint to call. Supports ``{{variable}}`` interpolation.
   * - Method
     - HTTP method: GET, POST, PUT, PATCH, DELETE.
   * - Headers
     - Key-value pairs added to the request headers.
   * - Query parameters
     - Key-value pairs appended to the URL as query string parameters.
   * - Body
     - Request body (JSON or form data). Supports ``{{variable}}`` interpolation.
   * - Response variable mapping
     - Map fields from the JSON response to flow variables using dot-notation paths.
   * - Advanced config
     - Timeout, retry count, success status codes, TLS options.

----

.. _chatbot-ref-make:

Make.com
--------

Triggers a Make.com (formerly Integromat) scenario via webhook.

**How to use**

Drag **Make.com** onto the canvas and enter the Make.com webhook URL. Configure the request body and response mapping the same way as the standard Webhook block.

**Configuration**

Uses the same fields as :ref:`Webhook (HTTP Request) <chatbot-ref-webhook>`. The URL is the Make.com scenario webhook endpoint.

----

.. _chatbot-ref-pabbly:

Pabbly
------

Triggers a Pabbly Connect workflow via webhook.

**How to use**

Drag **Pabbly** onto the canvas and enter the Pabbly Connect webhook URL. Configure the request and response mapping the same way as the standard Webhook block.

**Configuration**

Uses the same fields as :ref:`Webhook (HTTP Request) <chatbot-ref-webhook>`. The URL is the Pabbly Connect webhook endpoint.

----

.. _chatbot-ref-chatwoot:

Chatwoot
--------

Integrates with the Chatwoot customer support platform. Sets user information in Chatwoot or triggers a Chatwoot action.

**How to use**

Drag **Chatwoot** onto the canvas, enter the Chatwoot base URL and website token, and configure the user fields you want to set.

**Configuration**

.. list-table::
   :widths: 30 70
   :header-rows: 1

   * - Field
     - Description
   * - Task
     - The Chatwoot action to perform.
   * - Base URL
     - Your Chatwoot instance URL.
   * - Website Token
     - The website inbox token from Chatwoot.
   * - User ID
     - User identifier to set in Chatwoot.
   * - User email
     - User email to set in Chatwoot.
   * - User name
     - User display name to set in Chatwoot.
   * - Avatar URL
     - URL of the user's avatar image.
   * - Phone number
     - User phone number.

----

.. _chatbot-ref-flow-agent-block:

Flow Agent
----------

Calls an Agentic Flow agent from within a Chatbot flow. Use it to delegate multi-step reasoning, knowledge retrieval, or complex processing to a Flow Agent and return the result to the conversation.

**How to use**

Drag **Flow Agent** onto the canvas, select the target workspace and flow, configure the input message and any tweaks, and map the response to a variable.

**Configuration**

.. list-table::
   :widths: 30 70
   :header-rows: 1

   * - Field
     - Description
   * - Workspace
     - Workspace containing the target Agentic Flow.
   * - Flow
     - The Agentic Flow agent to call.
   * - API Key
     - API key for the flow (auto-filled from workspace credentials where available).
   * - Input message
     - Message or data to send to the flow. Supports ``{{variable}}`` interpolation.
   * - Session ID
     - Session ID for conversation continuity across calls.
   * - Conversation history
     - Optional conversation history passed to the sub-flow.
   * - Output component
     - Specific output component to retrieve from the flow.
   * - Tweaks
     - Key-value overrides for sub-flow parameters.
   * - Response mapping
     - Map response fields to flow variables.
   * - Timeout
     - Maximum seconds to wait for the flow response.
   * - Max retries
     - Number of retry attempts on failure.

----

.. _chatbot-ref-voice-agent-block:

Voice Agent
-----------

Triggers a Voice Agent call from within a Chatbot flow. Use it to initiate an outbound call or bridge to a voice agent at a specific point in the conversation.

**How to use**

Drag **Voice Agent** onto the canvas, select the target workspace and voice agent, fill in the call parameters, and store the response in a variable.

**Configuration**

.. list-table::
   :widths: 30 70
   :header-rows: 1

   * - Field
     - Description
   * - Workspace
     - Workspace containing the target Voice Agent.
   * - Voice Agent
     - The Voice Agent to trigger.
   * - Call parameters
     - Parameter table auto-populated from the selected voice agent. Fill in values for each parameter.
   * - Save response in variable
     - Variable to store the call response.