Integración de webhook

Se necesita la ayuda del equipo de desarrollo

Necesitará la ayuda de su equipo de desarrollo para configurar la integración. Por favor, comparta esta guía con ellos.

Descripción general de la integración

Esta integración le permite configurar un punto de conexión de Webhook para recibir datos en tiempo real de Pushwoosh, específicamente eventos de estado de correo electrónico, como Email Enviado, Email Entregado, Email Rebotado, Email Abierto, etc.

Tipo de integración

Fuente: Los datos se envían desde Pushwoosh a su sistema a través del webhook.

Glosario

Punto de conexión de Webhook: Una URL del lado del servidor que recibe solicitudes HTTP POST de Pushwoosh. Los clientes pueden especificar el puerto exacto.

• Ejemplo sin puerto: https://clientdomainname.com/webhook_endpoint
• Ejemplo con el puerto especificado: https://clientdomainname.com:8081/webhook_endpoint

Entidades sincronizadas

Eventos de estado de correo electrónico que proporcionan datos sobre las interacciones de los usuarios con los mensajes que usted envía.

Configuración de la integración

Para configurar la integración:

1. En su cuenta de Pushwoosh, vaya a Ajustes > Integraciones de terceros y busque Integración de Webhook. Haga clic en Configurar.

2. En la ventana que se abre, introduzca la URL completa del punto de conexión del webhook y haga clic en Aplicar.

Una vez configurado correctamente, comenzará a recibir solicitudes de Pushwoosh.

Cómo verificar que la integración funciona

Una vez configurada la integración, recibirá solicitudes HTTP POST de Pushwoosh en el punto de conexión del webhook especificado.

Cuerpo de la solicitud del Webhook

Nombre del campo	Tipo	Requerido	Descripción	Ejemplo
event_name	string	Sí	El nombre del evento	"Email Sent"
message_id	uint64	No	El ID único del mensaje asociado con el evento.	200XXXX3258
message_code	string	Sí	El código del mensaje asociado con el evento.	"B780-XXXXXX3C-XXXX0375"
campaign_id	uint64	No	El ID único de la campaña asociada con el evento.	96XXXX
platform	string	Sí	La plataforma del dispositivo asociada con el evento (por ejemplo, iOS, Android, Email).	"Email"
application_code	string	Sí	El código de la aplicación asociada con el evento.	"3XXXX-XXXX1"
hwid	string	Sí	El identificador del dispositivo (HWID) asociado con el evento.	"example@gmail.com"
user_id	string	Sí	El ID de usuario de Pushwoosh asociado con el evento.	"15XXXX8"
payload	string	No	El contenido relacionado con el mensaje depende de la plataforma. Para los eventos de correo electrónico, este contiene el asunto del correo electrónico. Para otras plataformas, puede incluir diferente contenido relevante específico para el evento (por ejemplo, contenido o título del mensaje).	"Don't miss our summer sale!"
timestamp	int64	Sí	La hora en que ocurrió el evento, en formato de marca de tiempo UNIX.	1723798222
journey_title	string	No	El título del Journey asociado con el evento.	"Summer sale"
journey_point_title	string	No	El título del punto específico dentro del Journey asociado con el evento.	"5_summer sale_new"

Ejemplo de solicitud

{
  "event_name": "Email Sent",
  "message_code": "B780-XXXXXX3C-XXXX0375",
  "campaign_id": 96XXXX,
  "platform": "Email",
  "payload": "Don't miss our summer sale!",
  "application_code": "3XXXX-XXXX1",
  "hwid": "example@gmail.com",
  "user_id": "15XXXX8",
  "timestamp": 1723798222,
  "journey_title": "Summer sale",
  "journey_point_title": "5_summer sale_promoemail"
}