1. Inicio
  2. Usando Widgets
  3. Uso de desencadenadores Webhook

Uso de desencadenadores Webhook

Integra Social Proofy con otra platforma/app a través de Webhooks para recopilar entradas/conversiones de formularios y crear Datos siguiendo esta guía.

Integración del activador Webhook

Paso 1 - Haz clic en el icono de Lapiz del Widget que desea conectar con Webhooks.

Edit Notification

Paso 2 - Ve a la pestaña de Webhook y Capturas , copia el URL Disparador de Webhook y pégalo en el área de Webhooks para la plataforma/aplicación que desees conectar.

Copy Webhook Trigger

Paso 2 - Si ha utilizados el Webhook Trigger, asegúrate de activar la opción de Webhook y carga debajo de Seleccionar versión de widget.

Webhook and Upload - Widget Version

Si utilizas el Plugin de Social Proofy para WordPress para WooCommerce y WordPress , activa Plugins debajo de Seleccionar versión de widget. 

Plugin - Widget Version

Comprueba si los Webhooks están Recopilando Datos

Para comprobar si tus Webhooks están recopilando datos, ve a la pestaña de Datos del widget que quieres comprobar.

Paso 1 - Haz clic en la pestaña Datos de notificación de tu configuración de widget.

Notification Data

Paso 2 - Si tu conexión Webhook está funcionando verás que se muestran los Datos de Conversión.

También notará que debajo de Tipo tendrá el nombre de la aplicación con la que se integró (Ej: WooCommerce) o dirá Webhook.

Webhook Notification Data

Así funcionan los Webhooks

¿Qué es un Webhook?
Un webhook, también conocido como web callback o HTTP push API, permite a una aplicación proporcionar instantáneamente datos en tiempo real a otras aplicaciones. Proporciona datos a otras aplicaciones en el momento en que se producen los eventos, garantizando el acceso inmediato a la información. A diferencia de las API convencionales, que requieren un sondeo frecuente para recuperar datos en tiempo real, los webhooks ofrecen una solución más eficaz tanto para los proveedores como para los consumidores.

Metodo HTTP
Utiliza el POST para todas sus solicitudes de webhook.

Campos opcionales
Los webhooks de Notificación de Conversión no necesitan ninguno de los parámetros siguientes, basta con una simple petición HTTP POST.

Naming of Parameters

It is possible that your webhook will send the parameters in another format. As in, instead of firstName it could be first_name. If so, insert the parameter as it was sent. In this case: {first_name}.

Parametros basicos
Los parámetros sólo se utilizan en los webhooks de widgets de conversión:

(requerido) email - obligatorio, el correo electrónico asociado a la conversión/al cliente potencial (cadena)
timestamp - una marca de tiempo numérica en milisegundos o segundos (entero)
ip - la IP del usuario, para mostrar la ubicación del usuario conversor, Geo IP (cadena)
firstName - el nombre de pila del cliente potencial (que aparece en la notificación); si no se indica, buscaremos el nombre utilizando el correo electrónico
lastName - el apellido del cliente potencial (sólo se muestra la primera letra en el icono/avatar), si no se proporciona, buscaremos el nombre utilizando el correo electrónico
city - la ciudad
country - el país (si se omite, se buscará utilizando countryCode)
country_code - el código de país (si se omite, se buscará utilizando el país)

{
“email”: “[email protected]”,
“timestamp”: 1325613278742, //optional
“ip”: “132.12.45.103”, //optional
“firstName”: “John”, //optional
“lastName”: “Doe” //optional
“guid”: “id” //optional, product/category identifier
“city”: “London”, // optional
“country”: “United Kingdom”,
“country_code”: “UK”, // optional
}

Parámetros de compra
El producto puede mostrarse después del texto del mensaje de notificación y hacer que la notificación enlace automáticamente con el producto.

productName - el nombre del producto (se añadirá al texto del mensaje)
productLink - el enlace/URL de la página del producto (redirigirá a este enlace al hacer clic)
productImage - el enlace/URL a la imagen del producto (se mostrará en la imagen de notificación)
total - importe total de la compra
currency - la moneda del importe del pedido

{
//ALL ARE OPTIONAL
“total”: 45,
“currency”: “USD”,
“productName”: “Shoes”, //required
“productLink”: “https://juststore.com/shoes”, //required
“productImage”: “https://juststore.com/shoes.jpg”
}

Parámetros de múltiples productos
Compras que tienen varios productos/artículos de línea (opcional).

products - lista de productos asociados al evento (propiedades del objeto):
(required) name - nombre del producto que se mostrará en la notificación (se añadirá al texto del mensaje).
(required) link - enlace a la página del producto
id - el id del producto
image - imagen del producto (óptima: imagen de 72×72)
price - precio del producto
quantity - número de artículos comprados

{
//OPTIONAL
“products”: [{
“name”: “T-Shirt”, //required
“link”: “https://juststore.com/t-shirt”, //required
“id”: 124, //can be a string
“image”: “https://juststore.com/images/t-shirt.png”,
“price”: 45,
“quantity”: 3
}]
}

Actualizado en 21/10/2024

¿Le ha resultado útil este artículo?

Articulos Relacionados