Versions Compared

Old Version 26

changes.mady.by.user Product Knowledge

Saved on

compared with

New Version Current

changes.mady.by.user Product Knowledge

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

On this page

Table of Contents
minLevel1
maxLevel2
outlinefalse
stylenone
typelist
printablefalse

\uD83D\uDCCB What’s about

Requirements

Image Removed

You can use WhatsApp Channel to manage inbound and outbound interactions, by configuring Meta Connector as provider.

(blue star) Requirements

Panel
bgColor
#FFEBE6
#EAE6FF
☑️

  • The Motion instance must have a public address accessible via HTTPS. For security reasons, we strongly recommend

to use
☑️

  • You

need

  • have to register an app as Meta Developers → find more details in next paragraph

  • You need 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 here

💡 How to Create an App for WhatsApp

To setup

🎬 Video Tutorial

https://app.guidde.com/share/playbooks/aTiMf4uRyrqfxVVqm5zDUr?origin=3wPlti10dEfOGQjG7BKQvB2q4IC3

To set up Meta Connector, you need to be registered as Meta Developers on http://developers.facebook.com and create an App for WhatsApp
By entering in your Meta account as Meta for Developers, you need to create an app.
First of all

Image Added

Firstly, you can click on My App → Create an app

Image RemovedImage Added

  • Choose Other option

  • Select Business

Image RemovedYou have to
choose Image Added

  • Choose display name for your app and app contact email

  • You need to connect Connect the app with your Account Business Manager

  • Create the app

Image Removed
Image Added

  • You will see the created app on the relative section

Image Removed
Image Added

  • Then, on the App Dashboard you have to choose WhatsApp to configure integration and click on Set up
    (You can follow Find our Meta documentation at this link here)

Image Removed
Image Added

  • Create or select your Meta Business Account and click on Continue to accept terms and conditions. By continuing you You will receive a WhatsApp test phone number to send test messages

Image Removed

Image Added

  • And click on “Start using the API” to proceed with API Configuration

Image Removed
So you can send Image Added

  • Send a test message to your phone number to verify if the integration works correctly (you can have a maximum of 5 recipients numbers)

Image Removed
Image Added

  • Then on step 5 you will be able to click on section Add a phone number

Image RemovedImage Added

You can insert:

  • Profile Name of WhatsApp Business

  • Choose a time zone

  • Business category

Image Removed

Image Added

  • You add WhatsApp 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

Image Removed

After creating the number and associating a payment method, Meta console will display a message like this:
Congratulations! Your display name XcallyTest was approved. Download and connect your phone number certificate to send messages to your customers.

For certificate management of WhatsApp Cloud API solution (which does not require an on-premise installation), it is NOT necessary to upload a certificate manually. In fact, Meta takes care of authentication and security management directly in the cloud platform.
So to link the phone number, just send a test message (using the default generated “hello_world” template).

Follow this procedure:

  • Generate an Access Token:

    • Go on WhatsApp → Quickstart

    • Select the created phone number

    • Generate token in section Access Token (you will use this token in your API requests to authenticate yourself)

image-20241111-143729.pngImage Added

  • Run a Test API Request, by using WhatsApp console to send the test message:

image-20241111-144505.pngImage Added

  1. Select in From the created WhatsApp Business number

  2. Fill in the field To with recipient number to which to send the template “hello_world”

  3. Click the button Send message

  4. Verify that the recipient has received it correctly

  • Otherwise you can make a request curl with WhatsApp API

image-20241111-144943.pngImage Added

  1. Use the token generated in an API call to verify that the setup is complete

Once you send the first test message, you will receive an email like this:

image-20241111-145200.pngImage Added

⚙️ Creation of WhatsApp Account on XCALLY

By entering in your XCALLY environment, you can go on WhatsApp Connector → WhatsApp Accounts to create a new account for outbound campaign

Image Removed

You have to click on + Image Added

Click on (blue star) button and enter:

Image Removed
Image Added

  • 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 number

  • Proxy or Motion Domain: server address

  • Type Meta

.

Image Removed
Image Removedimage-20240502-152300.pngImage Added

You can copy these data from your Business Meta account

  • Account SID = ID Account WhatsApp Business

  • Auth Token = Access Token ( (warning) you need to create a Permanent Access Token to use 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 with prefix (with +)

    • Click on Add

    Image Added

    How to create a permanent token

    With your Developer Account, to create a Permanent Access Token, you can follow Meta guidelines at this link to create a System User with specific permissions. So going on

    image-20240228-142250.pngImage Added

    Go to your Apps list page on your Meta for Developers account you can open Business settings and go

    on

    to Users → System users to create a new one, clicking on Add.

    Then you give a System Username and you choose “Admin” as User Role

    Image Modified

    • You can click on Add Assets and on Select asset type you choose Apps → you

    Image Added

    • You select WhatsApp created app, by enabling full control

    Image Removed

    Info

    Remember that you can create only 1 system user for Business account. However, if you generate more WhatsApp apps, and you click on Generate new token, the system allows you to select the app for which you want to create a permanent token

    image-20240228-142124.pngImage Added

    • So you can click on Generate new Token, by selecting your App and setting “Never”

    Image Added

    • Set “Never” as token expiration

    Image Removed

    • In addition to the WhatsApp_business_messaging permission 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

    Configuration of created account

    After account creation, you can edit it:

    Image AddedImage Added

    • on Settings tab you will see all information inserted before

    Image RemovedImage Removed

    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 that you can copy from advanced tab of your XCALLY account

    Note

    To configure correctly your callback URL, your server must have HTTPS certificate

    In addition to Callback URL, it is necessary to subscribe these webhook fields: -

    • account_alerts

    -

    • account_update

    -

    • message_template_status_update

    -

    • messages

    -

    • template_category_update

    Image Added

    • on Advanced tab

    Image Removed

    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

    • on Dispositions and Canned Answers you can create specific dispositions/canned answers for

    the

    • this account

    Image Added

    • on Actions you have to create dialplan to pass interactions to relative queue

    Image Removed

    info

    Obviously, you have to associate agents to queue and WhatsApp account that you want, otherwise they can’t manage interactions

    Image Added

    • on Interactions tab, you can see campaign interactions and relative status (explore more here)

    Image Removed

    🔌 Use WhatsApp Connector with

    META

    Meta for Agents

    For Agents, the feature is available on WhatsApp Connector section, from which they have to select accounts.
    In fact, agents need to enable be associated to the new created Meta account connected to Meta to receive new interaction from this account

    Image Removed

    interactions

    Image Added

    When a new inbound interaction arrives, the agent will see a popup with information about the account, queue and sender phone number.

    Agent can manage the conversation directly on omnidesktop interface

    Image Removed

    Omnidesktop interface

    Image Added

    For outbound campaigns, explore the relative section, at this link

    (blue star) Related topics

    Filter by label (Content by label)
    showLabelsfalse
    max5
    spacescom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@957
    maxCheckboxfalse
    showSpacefalse
    sortmodified
    typepage
    reversetrue
    labelswebrtc agent asterisk
    cqllabel = "meta" and type = "page" and space = "XM"

    Looking for something else?

    Live Search
    spaceKeyXM
    placeholderSearch by topic
    typepage