Skip to main content
This guide will help you connect bitbybit with n8n so you can:
  • Send incoming chats from Bitbybit into n8n
  • Send a reply back to your customer through bitbybit

Step 1: Set up in n8n

  1. Create a Project
    Open your n8n workspace and create a new project/flow.
    Screenshot2025 08 20at15 47 34 Pn
  2. Add a Webhook Trigger
    Choose Webhook as your trigger.
    Screenshot2025 08 20at15 48 05 Pn
  3. Copy the Webhook URL provided by n8n.
    This is where bitbybit will send incoming messages.
    Screenshot2025 08 20at15 48 12 Pn

Step 2: Setup in bitbybit

  1. Create an Automation
  2. Add an Action after the Trigger: HTTP Request
    • Add new Action -> HTTP Request
    Screenshot2025 08 20at15 51 08 Pn
    • Paste the Webhook URL from n8n into the URL field.
    Screenshot2025 08 20at15 51 16 Pn
    • (Optional) Add any custom header key and value.
  3. Save the automation.
Now, every incoming chat in bitbybit will be forwarded to your n8n.

Step 3: Test the Webhook in n8n

In n8n, test the webhook by sending a sample payload like this:
{
  "clientNumber": "{{your-phone-number}}",
  "clientName": "{{your-name}}",
  "messages": [
    {
      "body": "Hello, can you help my problem ?"
    }
  ]
}
At this stage, the message will flow into n8n, and you can decide what to do with it:
  • Forward to an AI Agent
  • Store in your database
  • Read your Knowledge Base
  • Send notifications
Or any other action supported by n8n

Step 4: Send a Reply Back to bitbybit

If your workflow includes sending a reply back to the customer (e.g., after AI Agent responds), follow these steps:
  1. Get Your API Key
  2. Add an HTTP Request in n8n
    • Choose the HTTP Request (POST) node.
    • Use this URL for sending a message:
      https://api.bitbybit.studio/whatsapp/api/v3.1/message
  3. Add Headers
    x-bitbybit-key: {{your-bitchat-api-key}}
  4. Add the Payload
    {
      "to": "{{client-number}}",
      "message": "{{message-body}}",
      "imageUrl": "{{image-url}}", // optional
      "sources": "{{messaging-channel}}",
      "ignoreActiveTicket": true // optional
    }
    
  • to → use the clientNumber from the incoming webhook
  • message → use the AI Agent’s reply or your custom message
  • imageUrl → optional, if you want to send an image
  • sources → set to WHATSAPP (WhatsApp Business App) or WHATSAPP_META (WhatsApp Cloud API)
  • ignoreActiveTicket → to ignore message delivery while the chat is being handled by an Agent, add the following field to the request body:)

📚 Additional Resources

For the full bitbybit WhatsApp API documentation, visit:
👉https://api.bitbybit.studio/whatsapp/docs
I