Skip to main content
Official Meta Tech Provider
Vocily is an official Meta Tech Provider. The WhatsApp integration connects your workspace to Meta’s WhatsApp Business Platform using Meta’s official setup paths: Login by Facebook or Manual Provisioning. You bring your own WhatsApp Business Account and phone numbers. You keep ownership of the account, numbers, data, and Meta billing relationship; Vocily connects on top so your workspace can use those Meta assets across agents, inbox workflows, templates, and campaigns. Vocily WhatsApp platform fees are separate from Meta’s WhatsApp Business Platform charges. See WhatsApp pricing and charges.

​
What the connection enables

After a WhatsApp Business Account is connected, your workspace can:
  • Reply to inbound WhatsApp conversations.
  • Assign WhatsApp numbers to agents.
  • Create and sync WhatsApp message templates.
  • Monitor conversations in the inbox.
  • Send WhatsApp campaigns from approved templates.
WhatsApp is connected at the workspace level, then configured per agent in Deploy WhatsApp on an agent.

​
Connect WhatsApp

Choose the connection path that matches how your Meta assets are managed:

Login by Facebook

Recommended for most workspaces. Sign in with Meta, choose the business, WhatsApp Business Account, and number, and authorize Vocily through Meta’s official onboarding flow. No access token or Meta app setup is needed from your side.

Manual Provisioning

Use this when your team already manages the Meta app and token. Paste the WABA ID, Phone Number ID, and access token, then add Vocily’s webhook details in Meta if you want inbound replies and AI conversations.
After connection, Vocily shows the connected WhatsApp Business Account and its numbers.

​
Login by Facebook

Use Login by Facebook when you want Meta to guide the setup in a secure popup. Before you start, make sure you have:
  • Meta Business admin access.
  • Access to the WhatsApp Business Account you want to connect, or permission to create one during Meta’s flow.
  • A WhatsApp business phone number, or a new number you want to add during Meta’s flow.
  • A 6-digit two-step verification PIN if Meta asks you to register or re-register the number.
If you add a new number during Meta’s flow, save this PIN somewhere safe. You may need the same PIN later if the number is registered again or moved between WhatsApp setups.
Meta Business verification, WhatsApp account eligibility, phone-number registration, payment methods, and any Meta billing requirements are managed in Meta by your business. Vocily connects to the Meta assets you authorize, but those Meta-side requirements remain under your ownership.
In Vocily:
  1. Open Integrations.
  2. Choose WhatsApp.
  3. Select Login by Facebook.
  4. Accept the WhatsApp Addendum + DPA shown in Vocily.
  5. Enter the 6-digit registration PIN.
  6. Continue with Meta and complete the popup. You can choose an existing WhatsApp business number or add a new number during the Meta setup.
Meta returns the WhatsApp Business Account ID, Phone Number ID, and an exchangeable token code to Vocily. Vocily exchanges that code server-side, registers the selected phone number for Cloud API use, subscribes the account to Vocily’s WhatsApp webhook, and imports the selected number into the workspace. You do not need to create your own Meta app for Login by Facebook. Vocily uses its official Tech Provider connection and follows Meta’s embedded signup flow for the authorization, phone registration, and webhook subscription steps. To learn more, see Meta’s Embedded Signup overview.

​
Manual Provisioning

Use Manual Provisioning when your Meta setup needs to stay under your own app. This path follows Meta’s Cloud API setup: you provide the WABA ID, Phone Number ID, and an access token with WhatsApp permissions. Before you start, collect: If you do not already have an access token, create one in Meta:
  1. Open the Meta App Dashboard and create or use an app with the WhatsApp use case.
  2. Make sure the Meta app is published, business verification is complete, WhatsApp account setup is ready, a payment method is added, and Meta billing requirements are completed in Meta for your business.
  3. In Meta Business Settings, create a System user.
  4. Assign the app and the WhatsApp Business Account to that system user with the required access.
  5. Generate a token with the permissions Vocily checks for WhatsApp Cloud API access: whatsapp_business_management and whatsapp_business_messaging. If Meta shows business_management instead of whatsapp_business_management, Vocily accepts it as the same management permission.
  6. Copy the token and keep it secure.
For Manual Provisioning, your Meta app and WhatsApp setup remain customer-managed. Please complete Meta’s business verification, app publishing, payment method, and billing setup inside Meta before relying on the connection in production. Vocily helps connect and use the approved assets, but Meta-side approvals and payments are handled by your business in Meta.
In Vocily:
  1. Open Integrations.
  2. Choose WhatsApp.
  3. Select Manual Provisioning.
  4. Accept the WhatsApp Addendum + DPA shown in Vocily.
  5. Enter the WABA ID, Phone Number ID, and Access Token. The access token is the same system-user token you created in Meta above.
  6. Select Connect & get webhook.
Vocily validates the token, checks that the selected phone number belongs to the WABA, imports that number, and returns a Callback URL and Verify token for the workspace.

​
Set up the Meta webhook

Webhook setup is required when you want inbound customer messages, AI replies, team replies, and delivery statuses to reach Vocily. Login by Facebook configures this through Vocily’s Tech Provider app. Manual Provisioning requires you to paste the webhook details into your own Meta app. For Manual Provisioning:
  1. Copy the Callback URL and Verify token shown by Vocily after connection.
  2. In the Meta App Dashboard, open your app.
  3. Open Use cases.
  4. Find Connect with customers through WhatsApp and select Customize.
  5. Open Step 2. Production Setup.
  6. Select Configure Webhooks.
  7. Paste the callback URL and verify token from Vocily.
  8. Select Save and verify.
  9. After Meta verifies the webhook, subscribe these webhook fields:
Use the version Meta shows in the field selector, such as v25.0. You can compare these fields with Meta’s WhatsApp Business Account webhook reference. Vocily uses one stable webhook URL and verify token per workspace for Manual Provisioning. If you connect more WhatsApp Business Accounts later, reuse the same workspace webhook details instead of creating a new callback for each number.
If you only plan to send outbound WhatsApp campaigns and do not need inbound replies or agent conversations, you can connect Manual Provisioning without completing the webhook step. To receive replies or run WhatsApp agents, complete the webhook setup.

​
What’s next