Integration with WhatsApp

 

Cet article est actuellement disponible en anglais et en espagnol. Vous pouvez vous servir de cette documentation en attendant qu'elle soit disponible dans votre langue.

Connectif has a direct synchronization with your Meta account, allowing you to create customized WhatsApp messaging campaigns in line with your objectives.

In this article, you’ll learn how to integrate your Connectif account with Meta and automate the sending of a purchase confirmation message.

  

Implementation time: 1 hour.
Difficulty: Intermediate
When to use it:
To create campaigns with WhatsApp.

 

This is an example of the many possibilities offered by this integration. By following the basic principles explained in this article, you'll be able to create more messaging strategies to help you meet your goals.

Before you start: prerequisites

In order to create WhatsApp campaigns and integrate your Connectif account with this channel, you will need:

  • A Meta Developer account (find out how to create it in their official documentation).
  • A WhatsApp application, created (find how to create it in the official documentation) and configured.
  • A telephone number authorized by Meta.
  

This number is exclusively for sending from the Meta Cloud API, i.e. it cannot be used on any device to answer messages or perform other actions.

 

STEP 1: Creating the customized integration in Connectif

1. Go to Store Backoffice in the left side menu.

2. In the tab selector, go to "Integrations > Custom integrations (webhooks)" and click Create new integration.

Integration with WhatsApp - 0-min.png

3. Set the "Integration name" field to identify the integration.

4. (Optional) Customize the color, add a description, or categorize the integration.

Integración con WhatsApp - 1-min.png

5. Click Update.

 

STEP 2: Creating the Outbound Event

(This section shows you how to configure the fields that will be shared with the external platform).

6. On the Send data tab, click Create new Outbound event.

Integración con WhatsApp - 2-min.png

 

2.1. Authorizing the Outbound Event

(In this section we will configure the headers that will allow WhatsApp messages to be sent from Connectif. To do this, some data from Meta must be copied into Connectif, so it is advisable to have both tabs open).

7. In the Meta WhatsApp application, go to API Settings and copy, from Step 2, the URL of the endpoint to which the request to send the messages is launched, as shown in the image:

Integración con WhatsApp - 3-min.png

8. Again in Connectif, paste this URL into the field Webhook URL to send the message to.

Integración con WhatsApp - 4-min.png

9. Click on Add a new header and name it "Authorization".

10. Copy the value associated with the Header that you will find in the Meta WhatsApp application, in Step 2 as shown in the image:

Integración con WhatsApp - 5-min.png

11. Paste it in the Value field of the header and click OK.

Integración con WhatsApp - 6-min.png

12. Repeat steps 9-11 with the rest of the HTML values in the header:

  • Create a header with the Name "Content-Type" and the Value "application/json".
  • Create a header with the Name "Accept-Encoding"and the Value "gzip, deflate, br".

 

2.2. Creating the message structure in Connectif

(In this section you will configure the properties of the WhatsApp message to be sent. The example documents the creation of a real, practical structure of a message.

  

To configure the WhatsApp message in Connectif, you will need to extract the message template structure to a JSON file based on the directions given in the official Meta documentation

13. Use a tool such as JSON Path Finder, which will allow you to extract the path of the properties you need to create.

Integración con WhatsApp - 7-min.png

14. In our example, the structure of the template to be replicated is:

{

  "type": "template",

  "to": "[phoneNumber]",

  "messaging_product": "whatsapp",

  "template": {

    "name": "post_purchase_template",

    "language": {

      "policy": "deterministic",

      "code": "ES"

    }

    "components": [

      {

        "type": "body",

        "parameters": [

          {

            "type": "text",

            "text": "[contactName]"

          }

        ]

      }

    ]

  }

}

15. Click on Create new Field.

 

Find more information about contact fields in this article.

16. Check the box Enable JSON options in the fields where necessary.

  

It’s necessary to enable JSON options when you need to send values of nested objects in the JSON, that is, when you need to simulate a complex structure with nested objects or arrays.

17. Copy the route and paste it into Connectif.

18. Edit the route, replacing the (x.) at the beginning and the (.) with backslashes.

 

For example, if the JSON path is x.template.components.0.type you should change it to /template/components/0/type.

19. Assign a name and ID to the field.

 

PRO TIP: Give the field in Connectif the same name as the JSON path to make it easier to locate.

Integración con WhatsApp - 8-min.png

20. Repeat this step for all properties to be passed until you have replicated the template.

21. Click   Save to record all fields.

 

STEP 3: Creating the workflow to send WhatsApps from Connectif

(This section explains how to send data from Connectif via a workflow).

22. Access from the left side menu to the Workflows.

23. Click Create new workflow and select Create blank workflow.

Integración con WhatsApp - 9-min.png

24. Create the structure of your workflow with a trigger node, in the example "On purchase", and the action node "Send WhatsApp". 

Integración con WhatsApp - 10-min.png

 

In our example, when a contact makes a purchase, a confirmation WhatsApp will be sent to them.

25. Configure the node by assigning the values (left column) to their respective fields (right column).

  • The contact information (name and phone number) comes from the Contact information.
  • All other fields must be set to a Literal value and populated with the template information, which can be extracted from the JSON.

Integración con WhatsApp - 11-min.png

  

Remember to configure the workflow for contacts with a cell phone only via the "Start" node.

26. Click Update to save the node configuration and your workflow. 

image (1).png

 

In our example, this would be the result of the WhatsApp message, where "Maria" is the contact name.

 

 

Success!
The integration of your Connectif account with WhatsApp is ready.

 


Keep learning!

To make the most of your Connectif account, we recommend reading these articles next:

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 0 sur 0