Conecta tu cuenta de Connectif con Qapla para sincronizar el estado de seguimiento de pedidos de tus contactos y personalizar la página de tracking de Qapla con Contenido Web de Connectif.
En este artículo, aprenderás cómo realizar la integración con Qapla para sincronizar la información de tracking de pedidos. Una vez realizada, podrás utilizar la data de Connectif para poder personalizar la página de seguimiento con contenido web de Connectif, así como enviar emails desde Connectif con la información del tracking. Ambas estrategias se encuentran disponibles al final de este artículo.
Tiempo de implementación: 30 min.
Dificultad: Fácil.
¿Cuándo utilizarlo?: Para recoger la data de Qapla e insertar contenido desde Connectif.
PASO 1: Creación del canal de Connectif en Qapla
1. Accede a tu cuenta de Qapla.
2. Dirígete a Canales y haz clic en Crea nuevo canal.
3. Asígnale el Nombre "Connectif" y, en Datos canal complétalos con la siguiente información, tal como se muestra en la imagen:
- En Dirección, introduce "www.connectif.ai".
- En Código, introduce "Connectif".
4. Haz clic en Añadir.
Paso 2: Inserción del snippet de Connectif en la tracking page de Qapla para recoger su actividad
5. Dirígete a tu cuenta de Connectif y accede a Configuración de tienda en el menú lateral izquierdo.
6. En el selector de pestaña, ve a "Canales > Web" y copia el script del apartado Script integración cliente.
7. Dirígete de nuevo a Qapla y entra en el canales, haz clic en Configura el canal de Connectif que has creado en el paso 1.
8. En "Marketing > Tracking page" pega el script que acabas de copiar en el apartado Script dentro HEAD.
9. Haz clic en Guardar.
Paso 3: Creación de la integración personalizada en Connectif
10. Dirígete a tu cuenta de Connectif y accede a Configuración de tienda en el menú lateral izquierdo.
11. En el selector de pestaña, ve a "Integraciones > Integraciones personalizadas (webhooks)" y haz clic en Crear nueva integración.
12. Establece el campo "Nombre de la integración" para identificar la integración.
13. (Opcional) Personaliza el color, incluye una descripción o categoriza la integración.
14. Haz clic en Actualizar.
PASO 4: Creación del evento de recepción
(En este apartado se explica cómo crear y configurar el evento que recibirá a la información sobre el estado del transporte del pedido de Qapla).
15. En la pestaña Recibir datos, haz clic en Crear nuevo evento de recepción.
16. Asígnale un nombre y el alias "order-status-change". Haz clic en Guardar.
17. Haz clic en Añadir un nuevo campo para crear cada uno de los campos personalizados y completa su información:
- Crea un campo con el nombre "courierStatus" y el ID "courierStatus" de tipo Texto.
- Crea un campo con el nombre "customerEmail" y el ID "customerEmail" de tipo Email y márcalo como requerido y clave primaria.
- Crea un campo con el nombre "customerName" y el ID "customerName" de tipo Texto y márcalo como requerido.
- Crea un campo con el nombre "language" y el ID "language" de tipo Texto.
- Crea un campo con el nombre "qaplaStatus" y el ID "qaplaStatus" de tipo Texto y márcalo como requerido.
- Crea un campo con el nombre "qaplaStatusID" y el ID "qaplaStatusID" de tipo Texto.
- Crea un campo con el nombre "reference" y el ID "reference" de tipo Texto y márcalo como requerido.
- Crea un campo con el nombre "trackingNumber" y el ID "trackingNumber" de tipo Texto y márcalo como requerido.
- Crea un campo con el nombre "trackingUrl" y el ID "trackingUrl" de tipo Texto y márcalo como requerido.
18. Haz clic en Guardar para conservar los cambios.
PASO 5: Conexión del evento de Connectif en Qapla para sincronizar la información
19. En la página del evento de recepción que acabas de crear, copia la URL del Endpoint.
20. Dirígete de nuevo a Qapla y, en la configuración del canal de Connectif, ve a "Marketing > Recomendaciones" y haz clic en Connectif.
21. En esa pantalla, asegúrate que la función de seguimiento de compras esté habilitada y pega, en URL del Webhook, la URL que acabas de copiar de Connectif, tal como se ve en la imagen.
22. Haz clic en Actualiza.
5.1. Creación y conexión de la API de consulta en Qapla
Si vas a enviar los emails de cambio de estado del pedido mediante Connectif, no sería necesario realizar este paso, aunque sí recomendable.
23. En tu cuenta de Connectif, accede a Configuración de Tienda en el menú lateral izquierdo.
24. En el selector de pestaña, ve a "API e IPs de Acceso > Claves API" y haz clic en Crear nueva API key.
25. En Permisos, marca en el área de Contactos la opción Lectura.
26. Haz clic en Guardar.
27. Copia la Clave ID que se ha generado para tu clave API.
28. Dirígete de nuevo a Qapla y, en "Marketing > Recomendaciones" entra en Connectif.
29. En esa pantalla, pega en API Key la clave que acabas de copiar.
30. Haz clic en Actualiza.
Anexo: cómo se verá el cambio de estado de pedido en Connectif
Una vez realizada esta integración, cuando el estado del pedido de un Contacto cambie, este se verá reflejado en la Actividad de su Ficha de Contacto.
Los estados por los que pasa un pedido se ven reflejados en campo elqaplaStatus y el campo qaplaStatusId de la integración (paso 4), corresponden a los códigos y valores en Qapla:
| ID | Código | Nombre italiano | Nombre español | Abreviatura italiano | Abreviatura español |
|---|---|---|---|---|---|
| 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 |
¡Éxito!
La integración de tu cuenta de Connectif con Qapla está lista.
¡Sigue aprendiendo!
Para aprovechar todo el potencial de tu cuenta en Connectif, te recomendamos continuar con los siguientes artículos:
- Qapla: Personalización de página de seguimiento de envío, para disponer de un ejemplo de estrategia de personalización en Qapla con contenido de Connectif.
- Qapla: Email de actualización de estado de envío de pedido, para comunicar las actualizaciones de envío de un pedido de compra desde Qapla.
- Integración personalizada para recibir datos, para aprender cómo hacer uso de información que no es registrada por defecto en la plataforma.
-
Integraciones vía API, para administrar eventos como registros de compras o altas de contactos.