"getting-started"
"How to Connect Zenvia WhatsApp to On-Chat"
"Connect your Zenvia WhatsApp number to On-Chat and manage two-way WhatsApp conversations, automate flows, and support customers at scale from one inbox."
Introduction
Zenvia is a leading communications platform in Latin America, offering businesses a WhatsApp Business API channel for customer engagement. If your organization already uses Zenvia for WhatsApp, you can connect your Zenvia number to On-Chat to centralize your messaging operations in one powerful inbox.
SEO Keywords: Zenvia WhatsApp, Zenvia WhatsApp API, Zenvia On-Chat integration, WhatsApp Business Latin America, Zenvia messaging platform
Prerequisites
- An active Zenvia account with a WhatsApp number provisioned
- Your Zenvia API token or API key from the Zenvia dashboard
- The WhatsApp phone number registered in Zenvia
- Admin access to your On-Chat workspace
Step 1: Retrieve your Zenvia API credentials
Log in to your Zenvia platform account and navigate to Developer Tools or API Configuration. Copy your API key and note the WhatsApp number associated with it.
Step 2: Open On-Chat channel settings
In On-Chat go to Settings → Channels → Add Channel and select Zenvia WhatsApp from the Social Network Channels list.
Step 3: Enter your Zenvia credentials
In On-Chat's setup form, paste your Zenvia API key and enter your WhatsApp phone number in international format (e.g. +5511999999999). Click Save Channel.
Step 4: Configure the webhook in Zenvia
On-Chat will provide a Webhook URL. Log back into your Zenvia dashboard and navigate to your WhatsApp channel settings. Paste the On-Chat webhook URL as the inbound message endpoint. Zenvia will POST all incoming WhatsApp messages to this URL.
Step 5: Assign the channel to an inbox
In On-Chat, go to Settings → Inboxes and assign your Zenvia WhatsApp channel to an inbox. Set up auto-welcome messages, working hours, and agent routing.
Step 6: Test the integration
Send a WhatsApp message to your Zenvia number from a personal phone. It should appear in your On-Chat inbox. Reply to verify outbound messaging is working.
Best Practices
- Configure Zenvia's sandbox environment first to test your integration before going live
- Use On-Chat's automation flows to handle FAQs and reduce manual agent workload
- Tag conversations with On-Chat labels (e.g. Sales, Support, Billing) for easy filtering and reporting
- Review Zenvia's message delivery reports alongside On-Chat's conversation analytics for full visibility