In the following section you find how to setup the Meta Solution Provider.
General Requirements
| Panel | ||
|---|---|---|
| ||
☑️ The Motion instance must have a public address accessible via HTTPS. For security reasons we strongly recommend to use a Reverse Proxy → find out more ☑️ You need to register an app as Meta Developers → find more details in next paragraph ☑️ You need to have a Meta Business Suite account ☑️ Consider that to use WhatsApp, on XCALLY side you need to enable the connector, while for interactions management you need to consult the official documentation of the selected provider to check prices: find out Meta's documentation at this link |
How to Create an App for
Whatsapp🎬 Video Tutorial
To setup Meta Connector, you need to be registered as Facebook Meta Developers on http://developers.facebook.com and create an App for WhatsappWhatsApp
By entering in your Meta account as Facebook Meta Developer, you need to create an app.
First of all you can click on My App → Create an app
Choose Other option
Select Business
-20230911-083711.jpg?version=2&modificationDate=1700827055996&cacheVersion=1&api=v2&width=611)
You have to choose display name for your app and app contact email
You need to connect the app with your Account Business Manager
Create the app
You will see the created app on the relative section
Then on the App Dashboard you have to choose Whatsapp WhatsApp to configure integration and click on Set up
And click Click on “Start using the API” to proceed with API Configuration
Create or select your Meta Business Account and click on Continue to accept terms and conditions. By continuing you will receive a Whatsapp WhatsApp test phone number to send test messages
-20231121-133536.jpg?version=1&modificationDate=1700827056027&cacheVersion=1&api=v2&width=388)
So you can send a test message to your phone number to verify if integration works correctly (you can have a maximum of 5 recipients numbers)
Then on step 5 you will be able to click on section Add a phone number
-20231106-163937.jpg?version=2&modificationDate=1700827056048&cacheVersion=1&api=v2&width=658)
You can insert:
Profile Name of Whatsapp WhatsApp Business
Choose a time zone
Business category
-20231106-144729.jpg?version=2&modificationDate=1700827056075&cacheVersion=1&api=v2&width=715)
You add Whatsapp WhatsApp Business phone number, by choosing prefix and, according to the selected option, you will receive a text message with a pin code or a phone call to verify your number
-20231106-145011.jpg?version=2&modificationDate=1700827056096&cacheVersion=1&api=v2&width=543)
Moreover it is mandatory to configure a payment method to send messages to customers
Creation of
WhatsappWhatsApp Account on XCALLY
By entering in your XCALLY environment you can go on Whatsapp WhatsApp Connector → Whatsapp WhatsApp Accounts to create a new account for outbound campaign
You have to click on + button and enter:
Account Name
Key: identification code of maximum 5 characters
List: Contact Manager list used to associate contacts. When you run campaigns, contacts are added to this Master List, so it’s possible to have a unique customer journey with all customer touchpoints with outbound campaigns.
| Info |
|---|
For all contacts in the Master List to be usable, it is necessary that they contain in the Phone Field the Whatsapp WhatsApp number |
Proxy or Motion Domain: server address
Type Meta
.
-20231106-150225.jpg?version=2&modificationDate=1700827056181&cacheVersion=1&api=v2&width=652)
Account SID = ID Account Whatsapp WhatsApp Business
Auth Token = Access Token ( follow at this link Meta guidelines
you need to create a Permanent Access Token to use Whatsappcorrectly by creating WhatsApp correctly because access token expires after 24 hours. Follow these guidelines)AppId = ID app
Phone number Id = ID phone number
Prefix of phone number
Phone number
Click on Add
How to create a permanent token
To create a Permanent Access Token you can follow at this link Meta guidelines to create a System User with specific permissions
).
So
going on your Apps list page on your Meta for Developers account you can open Business settings and go on Users → System users to create a new one. Then you give a System Username and you choose “Admin” as User Role
-20231127-085513.jpg?version=1&modificationDate=1701075330156&cacheVersion=1&api=v2&width=734)
You can click on Add Assets and on Select asset type you choose Apps → you select WhatsApp created app, by enabling full control
-20231127-085806.jpg?version=1&modificationDate=1701075490605&cacheVersion=1&api=v2&width=228)
So you can click on Generate new Token, by selecting your App and setting “Never” as token expiration
-20231127-090159.jpg?version=1&modificationDate=1701075737540&cacheVersion=1&api=v2&width=577)
In addition to the
WhatsApp_business_messagingpermission indicated in the guide, you need to add also these permits:pages_show_list
pages_messaging,
WhatsApp_business_management
pages_manage_metadata
And click on "Generate Token" to obtain a permanent token to paste on auth token section
AppId = ID app
Phone number Id = ID phone number
Prefix of phone number
Phone number
Click on Add
After account creation, you can edit it:
on Settings tab you will see all information inserted before
Moreover you will view Receive URL, an auto-generated API string you need to use to receive the messages inside your account from your WhatsApp Connector provider: click the clipboard button to copy it and then on your Meta Account you need to Configure webhook
By clicking on Configure webhook you need to insert callback URL (paste here code copied before) + verify token
-20231106-150634.jpg?version=2&modificationDate=1700827056239&cacheVersion=1&api=v2&width=413)
In addition to Callback URL, it is necessary to manage these webhook fields:
account_alertsaccount_updatemessage_template_status_updatemessages
on Advanced tab
You can see info about proxy and token number
You can enable mandatory disposition (by creating dispositions on relative section) and you can select Recontact Template from those created
on Canned Answers you can create specific canned answers for the account
on Actions you have to create dialplan to pass interactions to relative queue
| Info |
|---|
Obviously you have to associate agents to queue and |
WhatsApp account that you want, otherwise they can’t manage interactions |
on Interactions tab you can see campaign interactions and relative status (explore more here)
Use
WhatsappWhatsApp Connector with META for Agents
For Agents, the feature is available on Whatsapp WhatsApp Connector section, from which they have to select accounts.
In fact agents need to enable the new created account connected to Meta to receive new interaction from this account
When a new interaction arrives, agent will see a popup with information about the account, queue and sender phone number.
Agent can manage the conversation directly on omnidesktop Omnidesktop interface
