Qapla integration

Connect your Connectif account with Qapla to synchronize the tracking status of orders from your contacts and customize the Qapla tracking page with Connectif Web Content.

In this article, you will learn how to perform the integration with Qapla to synchronize order tracking information. Once completed, you will be able to use Connectif data to customize the tracking page with Connectif's web content and send emails from Connectif with tracking information. Both strategies are available at the end of this article.

  

Implementation Time: 30 min.
Difficulty: Easy.
When to use it?:
To collect data from Qapla and insert content from Connectif.

STEP 1: Connectif Channel Creation in Qapla

1. Access your Qapla account.

2. Go to Channels and click on Create New Channel.

Integration with Qapla - 1-min.png

3. Assign the Name "Connectif" and, in Channel Data, fill it out with the following information, as shown in the image:

  • In Address, enter "www.connectif.ai".
  • In Code, enter "Connectif".

4. Click on Add

Integration with Qapla - 2-min.png

 

Step 2: Insertion of Connectif snippet in Qapla tracking page to collect its activity

5. Go to your Connectif account and access Store Configuration in the left sidebar menu.

6. In the tab selector, go to "Channels > Web" and copy the script from the section Client Integration Script.

Integration with Qapla - 3-min.png

7. Go back to Qapla and enter the channels, click on Configure the Connectif channel you created in step 1.

Integration with Qapla - 4-min.png

8. In "Marketing > Tracking page", paste the script you just copied in the Script within HEAD section.

Integration with Qapla - 5-min.png

9. Click Save.

 

Step 3: Creating the Custom Integration in Connectif

10. Go to your Connectif account and access Store Settings in the left sidebar menu.

11. In the tab selector, go to "Integrations > Custom Integrations (webhooks)" and click on   Create New Integration.

Integration with WhatsApp - 0-min.png

12. Set the "Integration Name" field to identify the integration.

13. (Optional) Customize the color, include a description, or categorize the integration.

Integration with Qapla - 6-min.png

14. Click on  Update.

 

STEP 4: Creation of the Reception Event

(In this section, it is explained how to create and configure the event that will receive information about the transport status of the Qapla order).

15. In the Receive Data tab, click on  Create New Reception Event.

16. Assign it a name and the alias "order-status-change". Click on  Save.

Integration with Qapla - 7-min.png

17. Click on   Add a New Field to create each of the custom fields and complete their information:

  • Create a field named "courierStatus" with the ID "courierStatus" of type Text.
  • Create a field named "customerEmail" with the ID "customerEmail" of type Email and mark it as required and primary key.
  • Create a field named "customerName" with the ID "customerName" of type Text and mark it as required.
  • Create a field named "language" with the ID "language" of type Text.
  • Create a field named "qaplaStatus" with the ID "qaplaStatus" of type Text and mark it as required.
  • Create a field named "qaplaStatusID" with the ID "qaplaStatusID" of type Text.
  • Create a field named "reference" with the ID "reference" of type Text and mark it as required.
  • Create a field named "trackingNumber" with the ID "trackingNumber" of type Text and mark it as required.
  • Create a field named "trackingUrl" with the ID "trackingUrl" of type Text and mark it as required.

Integration with Qapla - 8-min.png

18. Click on Save to keep the changes.

 

STEP 5: Connecting the Connectif Event in Qapla to Synchronize Information

19. On the reception event page you just created, copy the Endpoint URL.

Integration with Qapla - 9-min.png

20. Go back to Qapla and, in the Connectif channel settings, go to "Marketing > Recommendations" and click on Connectif.

Integration with Qapla - 10-min.png

21. On that screen, make sure the purchase tracking function is enabled and paste, in Webhook URL, the URL of the event you created in Connectif. Then, click  Save.

 

Integration with Qapla - 11-min.png

22. Click on Update.

 

5.1. Creation and connection of the Qapla query API 

  

If you are going to send order status change emails through Connectif, this step would not be necessary, although recommended. 

23. In your Connectif account, go to Store Settings in the left sidebar menu.

24. In the tab selector, go to "API and Access IPs > API Keys" and click on   Create new API key.

Integration with Qapla - 12-min.png

25. In Permissions, check the Read option in the Contacts area.

Integration with Qapla - 13-min.png

26. Click on Save.

27. Copy the Key ID generated for your API key.

Integration with Qapla - 14-min.png

28. Go back to Qapla and, in "Marketing > Recommendations," enter Connectif.

29. On that screen, paste the key you just copied into the API Key field. 

Integration with Qapla - 15-min.png

30. Click on Update.

 

Appendix: how the order status change will look in Connectif

Once this integration is done, when the order status of a Contact changes, it will be reflected in the Activity of their Contact Sheet.

Integration with Qapla - 16-min.png

The statuses through which an order passes are reflected in the elqaplaStatus field and the qaplaStatusId field of the integration (step 4), corresponding to the codes and values in Qapla:

ID Code Italian name Spanish Name Italian abbr. Spanish abbr.
0 WAITING TO COMPUTE Attesa Elaborazione Esperando elaboración Attesa Elab.  
1 PENDING In sospeso Pendiente    
2 INFO RECEIVED Attesa ritiro Pendiente de retirar   Pendiente
3 IN TRANSIT In transito En tránsito    
4 OUT FOR DELIVERY In consegna En reparto    
5 FAILED ATTEMPT Tentativo di consegna fallito Intento de entrega fallido Consegna fallita Entrega Fallida
6 EXCEPTION Eccezione Problema Problemi  
8 DELAY Ritardo En Retraso    
10 PICKUP POINT Punto di Ritiro Punto de retiro    
20 DEPARTED Partito Enviado    
50 PROCESSING In lavorazione En elaboración    
95 RETURNED Rientrato Restituido    
99 DELIVERED Consegnato Entregado    

 

 

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

 


Keep learning!

To take full advantage of your Connectif account, we recommend continuing with the following articles:

 

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