whatsapp-cloud-app-configuration.md

WhatsApp Cloud App Configuration

With the WhatsApp Cloud App installed on your public Rocket.Chat workspace and the Facebook Developer App Created for WhatsApp, you can now:

• Connect WhatsApp number
• Edit WhatsApp numbers
• Disconnect WhatsApp number

WhatsApp Cloud App Shortcuts

The WhatsApp Cloud app has a list of shortcuts to ease usage. Use the slash command /whatsapp help to see the list of shortcuts and their functions

• /whatsapp connect: to connect a new WhatsApp number
• /whatsapp numbers: to view and edit all connected WhatsApp number
• /whatsapp support: Get support information
• /whatsapp help: to see this shortcut menu

Connect WhatsApp Number

{% hint style="success" %} You can add as many WhatsApp number connected to a Facebook app as you wish. {% endhint %}

• Click on Connect WhatsApp Number on the first message sent by the whatsapp-cloud.bot or use the slash command /whatsapp connect

Connect WhatsApp Number

• A modal opens up with details to be filled

Connect new WhatsApp number

• Head over to your Facebook Developer Account and get the details from the app we created above then Conect
  • PhoneNo Id: The WhatsApp phone number ID you want to connect
  • WhatsApp Business Id: The WhatsApp Business Account ID of the WhatsApp number to connect
  • Access Token: The App's access token, it can be either temporary or permanent
  • Facebook App Secret: The Facebook App's secrete. This secret is used to verify if the messages are sent from authorized WhatsApp servers
  • Welcome Message: First message your customer will receive upon messaging you
  • Conversation Finished Message: Message sent to your customer when an agent closes the conversation
  • Default message for offline service: Message sent to your customer when no agents are available online

Facebook app credentials

Setup Facebook app webhook url

• After saving, you receive a message to configure the callback url in you app.

{% hint style="info" %} This is a one-time process. {% endhint %}

Configure Facebook App webhook

• Go to your the App created on your Facebook Developer Console
• Navigate to WhatsApp > Configuration and paste the callback URL and Verify Token provided by Rocket.Chat then Verify and save

Set Facebook app callback URL

• Still on the configuration page, click on Manage across the Webhook fields

Manage Facebook app webhook fields

• Subscribe to messages and Done

Subscribe to Messages webhook Facebook app

{% hint style="success" %} After subscribing to the messages, the Rocket.Chat WhatsApp Cloud app is ready to use. {% endhint %}

Edit WhatsApp Cloud Number

To edit an already set WhatsApp number,

• Type the slash command /whatsapp numbers
• A list of connected numbers are shown. Click on Edit across the number you wish to edit

Edit WhatsApp Cloud number

• Make the necessary changes and Update

Disconnect WhatsApp Number

To disconnect a WhatsApp number,

• Type the slash command /whatsapp numbers
• A list of connected numbers are shown. Click on Disconnect across the number you wish to disconnect
• Confirm the prompt to Disconnect

Disconnect WhatsApp number

• You get a message notifying about the disconnection