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.
STEP 1: Connectif Channel Creation in Qapla
1. Access your Qapla account.
2. Go to Channels and click on Create New Channel.
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.
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.
7. Go back to Qapla and enter the channels, click on Configure the Connectif channel you created in step 1.
8. In "Marketing > Tracking page", paste the script you just copied in the Script within HEAD section.
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.
12. Set the "Integration Name" field to identify the integration.
13. (Optional) Customize the color, include a description, or categorize the integration.
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.
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.
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.
20. Go back to Qapla and, in the Connectif channel settings, go to "Marketing > Recommendations" and click on Connectif.
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.
22. Click on Update.
5.1. Creation and connection of the Qapla query API
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.
25. In Permissions, check the Read option in the Contacts area.
26. Click on Save.
27. Copy the Key ID generated for your API key.
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.
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.
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 |
Keep learning!
To take full advantage of your Connectif account, we recommend continuing with the following articles:
- Qapla: Shipment tracking page customization, to have an example of customization strategy in Qapla with Connectif content.
- Qapla: Order shipment status update email, to communicate shipping updates of a purchase order from Qapla.
- Custom integration to receive data, to learn how to make use of information that is not registered by default in the platform.
-
API integrations, to manage events like purchase registrations or contact sign-ups.