Bitrix24 Chat Automation Agent: Event Handler & Responder

Unlock Seamless Bitrix24 Chat Automation with this Agent

This n8n workflow empowers you to build a responsive and integrated chatbot for Bitrix24. It acts as the backbone for your Bitrix24 chat application, efficiently handling incoming events such as new messages, app installations, and user interactions. By connecting directly to your Bitrix24 instance via webhooks and API calls, this agent automates key chatbot functionalities, allowing you to focus on crafting valuable user experiences.

Key Abilities & Benefits

• Event-Driven Chat Management: Automatically processes critical Bitrix24 events: ONIMBOTMESSAGEADD (new messages), ONIMBOTJOINCHAT (user joins), ONAPPINSTALL (app installation), and ONIMBOTDELETE (bot deletion).
• Direct Bitrix24 Integration: Seamlessly interacts with Bitrix24 APIs to register your bot, send messages, and manage chat dialogues.
• Real-time Event Processing: Leverages n8n's webhook capabilities to react to Bitrix24 events instantly.
• Flexible Response Logic: Utilizes n8n Function nodes to define custom responses and actions tailored to different chat events and message content. This example provides a basic echo bot and a 'what's hot' response; expand it with your own business logic or connect to LLMs for advanced conversational AI.
• Secure Webhook Handling: Includes an initial token validation step to help protect your webhook endpoint against unauthorized calls.
• Streamlined Bot Operations: Simplifies the technical overhead of deploying and maintaining a Bitrix24 chatbot, from installation to ongoing message handling.

• An n8n instance (Cloud or self-hosted).
• A Bitrix24 account with permissions to install applications and manage webhooks.
• Bitrix24 application credentials: Your specific CLIENT_ID (Application ID) and CLIENT_SECRET obtained when registering your application/bot in Bitrix24.
• The webhook URL generated by the 'Bitrix24 Handler' node in this workflow needs to be configured in your Bitrix24 application settings.

1. Download the n8n workflow JSON file.
2. Import the workflow into your n8n instance.
3. The 'Bitrix24 Handler' (Webhook node) will generate a unique Test URL and Production URL. Copy the Production URL.
4. In your Bitrix24 application/bot settings, configure this Production URL as the handler for relevant bot events (e.g., ONIMBOTMESSAGEADD, ONAPPINSTALL, ONIMBOTJOINCHAT, ONIMBOTDELETE). Refer to Bitrix24 documentation for setting up bot event handlers.
5. Configure the 'Credentials' (Set node):
   • Replace the placeholder CLIENT_ID value with your Bitrix24 application's actual Client ID. This workflow uses it to validate the auth[application_token] from incoming webhook requests.
   • Replace the placeholder CLIENT_SECRET value with your Bitrix24 application's actual Client Secret.
6. Review and customize the JavaScript in the 'Process Message', 'Process Join', and 'Process Install' Function nodes to tailor the bot's responses, registration details (like bot name, color), and overall behavior.
7. Examine the 'Register Bot', 'Send Message', and 'Send Join Message' HTTP Request nodes. Ensure the API endpoints dynamically use {{ $json.DOMAIN }} and that authentication parameters (auth={{$json.AUTH}}) correctly use the access_token provided by Bitrix24 events. The 'Register Bot' node, for example, sends the CLIENT_ID (from the 'Credentials' node) and uses the incoming access_token (via {{$json.AUTH}}) as the CLIENT_SECRET parameter in its payload – verify this aligns with Bitrix24's requirements for imbot.register.
8. Activate the workflow.
9. Test by triggering the configured events in Bitrix24 (e.g., installing the app, sending a message to the bot). Check n8n execution logs for troubleshooting.