logo

WhatsApp Connect to SMS-iT Smart Inbox

This guide will help you to connect your Business WhatsApp number to the SMS-iT Smart Inbox.

A Facebook Business Account is required (you'll need to have or add a payment method).

Note: While connecting your WhatsApp Business Account is not required for this guide, we will only be connecting a test number from Facebook to verify the connection between SMS-iT and Facebook. However, if you intend to use your actual WhatsApp Business number, you'll need to link your Facebook Business Account with your WhatsApp Business Account.

Here's a link to help you connect your Facebook Business Account to your WhatsApp Business Account: https://www.facebook.com/business/help/1583303048513172?id=2129163877102343. You'll eventually need to connect your Facebook Business Account and your WhatsApp Business Account to use your WhatsApp number in the SMS-iT Smart Inbox. But first, let's connect the test number from Facebook to get the SMS-iT platform and Facebook platform integrated.

We'll be toggling between the SMS-iT platform, the Facebook Business platform, and the Facebook Developer platform. The URLs will be in the guide as we go.

2

Click on "Quick Links"

Click on "Quick Links"
3

Click on "Smart Inbox"

Click on "Smart Inbox"
4

Click on "Inbox"

Click on "Inbox"
5

Click on "Add Inbox"

Click on "Add Inbox"
6

Click on "WhatsApp".

Click on "WhatsApp".
7

Click on "Next"

Click on "Next"
8

We will fill in this info.

We will fill in this info.

Create App in Facebook

To successfully integrate with the SMS-iT Platform, the following prerequisites are required:

A Facebook Business Account. (You'll need to have or add a payment method.) A WhatsApp Business Account. It's important to note that your WhatsApp Business Account must be linked to your Facebook Business Account. (Please note that this tutorial does not cover the process of linking these accounts, although it is relatively simple to do so).

10

Click on the account you'll be using.

Click on the account you'll be using.
11

Click on "Apps"

Click on "Apps"
12

Click on "Add"

Click on "Add"
13

Click on "Create a new app ID."

Click on "Create a new app ID."
14

Click on "Other"

Click on "Other"
15

Click on "Next"

Click on "Next"
16

Click on "Business"

Click on "Business"
17

Click on "Next"

Click on "Next"
18

Name your app in the "Add an app name" field.

Name your app in the "Add an app name" field.
19

Click on "Create app"

Click on "Create app"
20

You'll be required to re-enter your password.

You'll be required to re-enter your password.
21

Click on "Submit"

Click on "Submit"
22

Your App has been created navigate back to: https://business.facebook.com/settings/system-users/

Your App has been created navigate back to: https://business.facebook.com/settings/system-users/

Create Token

24

Click on "Generate new token"

Click on "Generate new token"
25

Click on "Select an app"

Click on "Select an app"
26

Click on "Your New App" that you just created.

Click on "Your New App" that you just created.
27

Click on "Never" expires.

Click on "Never" expires.
28

Scroll down.

Scroll down.
29

Select "whatsapp_business_management" and "whatsapp_business_messaging"

Select "whatsapp_business_management" and "whatsapp_business_messaging"
30

Click on "Generate token"

Click on "Generate token"

Do not click on "OK" until you have copied your token.

31

Before proceeding, manually highlight and copy your token. Do not click "OK" before copying it and pasting it into the SMS-iT field labeled "Access Token".


Before proceeding, manually highlight and copy your token. Do not click "OK" before copying it and pasting it into the SMS-iT field labeled "Access Token".
32

Paste into "Access Token"

Paste into "Access Token"
33

Click on "OK"

Click on "OK"
34

Token copy/pasted.

Token copy/pasted.

Take App "Live"

36

Click on "My Apps"

Click on "My Apps"
37

Click on image

Click on image
38

Click on "App settings"

Click on "App settings"
39

Click on "Basic"

Click on "Basic"
40

Paste your Privacy Policy URL into the field.

Paste your Privacy Policy URL into the field.
41

Paste your "Terms of Service URL" into the field.

Paste your "Terms of Service URL" into the field.
42

Click on "Save changes"

Click on "Save changes"

This should be all the fields required to go "Live". If you need other requirements follow the Facebook prompts.

Get WhatsApp API details.

43

Click on "Whatsapp"

Click on "Whatsapp"
44

Click on "API Setup"

Click on "API Setup"
45

Click on "Whatsapp Business Account ID"

Click on "Whatsapp Business Account ID"
46

Paste into "WhatsApp Business Account ID"


Paste into "WhatsApp Business Account ID"
47

Copy "Phone number ID"

Copy "Phone number ID"
48

Paste into "Phone number ID"

Paste into "Phone number ID"
49

Click on "Create WhatsApp "

Click on "Create WhatsApp
                                  "
50

Click on "Create WhatsApp Channel" "

Click on "Create WhatsApp Channel"
                                  "
51

Channel connected. Note: You'll see the "Unlink Whatsapp" icon if the system is linked.

Channel connected. Note: You'll see the "Unlink Whatsapp"  icon if the system is linked.

Add Webhook and Verify Token

52

Click on "Configuration"

Click on "Configuration"
53

Click on "Continue"

Click on "Continue"
54

We'll retrieve Callback URL and Verify Token

We'll retrieve Callback URL and Verify Token
55

Click on "Next"

Click on "Next"
56

Click on "Next"

Click on "Next"
57

Click on "Copy" Callback URL

Click on "Copy" Callback URL
58

Click on "Edit"

Click on "Edit"
59

Paste "Callback URL"

Paste "Callback URL"
60

Click on "Copy" Verify Token.

Click on "Copy" Verify Token.
61

Paste "Verify Token" and click "Verify and save"

Paste "Verify Token" and click "Verify and save"
62

Your webhook is verified

Your webhook is verified
63

Click on "Manage"

Click on "Manage"
64

Scroll down.

Scroll down.
65

Click here

Click here
66

Click on "Done"

Click on "Done"
67

Ready to test.

Ready to test.

Test SMS-iT inbox

First, we will verify a WhatsApp number in Facebook. Then, we will test that number in Facebook.

NOTE: Use a WhatsApp number that isn't connected to your Facebook account, such as a personal WhatsApp number.

68

Click on "API Setup"

Click on "API Setup"
69

You'll automatically be given a "Test number" to send and receive messages.

You'll automatically be given a "Test number" to send and receive messages.
70

Click on "Select a recipient phone number". In these steps, you'll add a number that is a WhatsApp number that you either own or have access to. This will be your test number to test the SMS-iT system.


Click on "Select a recipient phone number". In these steps, you'll add a number that is a WhatsApp number that you either own or have access to. This will be your test number to test the SMS-iT system.
71

Click on "Manage phone number list"

Click on "Manage phone number list"
72

Click on "Add phone number"

Click on "Add phone number"
73

Click on "Next"

Click on "Next"
74

You'll get a verification code in your Whatsapp messages on your phone or desktop.

You'll get a verification code in your Whatsapp messages on your phone or desktop.
75

After you verify your WhatsApp number for testing, click on "Send message". This will send a message generated from your Facebook test number and will land in your WhatsApp messages.

After you verify your WhatsApp number for testing, click on "Send message". This will send a message generated from your Facebook test number and will land in your WhatsApp messages.

Add new contact and test Smart Inbox.

76

Click on "Quick Links"

Click on "Quick Links"
77

Click on "Add a Contact"

Click on "Add a Contact"
78

Select a group.

Select a group.
79

Enter a first and last name (entering a name isn't mandatory; we're doing this just for easy reference).


Enter a first and last name (entering a name isn't mandatory; we're doing this just for easy reference).
80

Enter a "dummy" phone number. This is not the WhatsApp number, but you need to enter this field to save. It is mandatory.

Enter a "dummy" phone number. This is not the WhatsApp number, but you need to enter this field to save. It is mandatory.
81

Click on "Social Networks"

Click on "Social Networks"
82

Click on "Add Social Details"

Click on "Add Social Details"
83

Please enter the WhatsApp number that you verified in your Facebook account in the previous steps.

Please enter the WhatsApp number that you verified in your Facebook account in the previous steps.
84

Click on "Submit".

Click on "Submit".

Testing Whatsapp in Smart Inbox

85

Click on "Quick Links"

Click on "Quick Links"
86

Click on "Smart Inbox"

Click on "Smart Inbox"
87

Click on "Unassigned"

Click on "Unassigned"
88

Click on your newly added contact with the WhatsApp number.

Click on your newly added contact with the WhatsApp number.
89

Click "Social Media" icon.

Click "Social Media" icon.
90

Click "Whatsapp" icon

Click "Whatsapp" icon
91

Send Message

Send Message

Important: If you do not receive the message, reply to the message you received from Facebook using the test message number.

92

After a few tests back and forth, the inbox should work properly. You may need to refresh the screen to get the first few messages to appear.

After a few tests back and forth, the inbox should work properly. You may need to refresh the screen to get the first few messages to appear.

Adding WhatsApp Business number.

93

From "API Setup" click on the free number.

From "API Setup" click on the free number.
94

Click on "Add phone number"

Click on "Add phone number"
95

Fill in the info.

Fill in the info.
96

Select a number you'd like for your WhatsApp business number. IMPORTANT: If you're adding your existing business number, you'll have to delete it first and then re-add it here, as well as to your phone and other applications. (Ensure you back up all your chats, etc.)

Select a number you'd like for your WhatsApp business number. IMPORTANT: If you're adding your existing business number, you'll have to delete it first and then re-add it here, as well as to your phone and other applications. (Ensure you back up all your chats, etc.)
97

Click on "Next" and enter the verification number to complete the setup process.

Click on "Next" and enter the verification number to complete the setup process.

That completes the Whastapp to SMS-iT integration.