Acerca de los webhooks

En marketing, ayuda a coordinar tus campañas de marketing con otras acciones en tu sitio web y otros canales, como los mensajes de texto y el correo directo. Los webhooks son una forma de sincronizar la actividad de Mailchimp con aplicaciones de terceros.

En este artículo, veremos cómo puedes crear un webhook en la aplicación de Mailchimp.

Antes de empezar

• Para utilizar webhooks, debes estar en el plan Standard o Premium. Si estás en el plan Essentials o Free, los usuarios pueden configurar el webhook y ver la función, pero se les pedirá que se actualicen antes de habilitar el punto de recorrido. Para cambiar el tipo de plan, visita la página de planes de tu cuenta.
• Recomendamos los webhooks a los usuarios que estén familiarizados con la codificación personalizada. Contacta con tu desarrollador o contrata a un experto de Mailchimp si necesitas ayuda.
• Este artículo explica cómo añadir webhooks en Mailchimp. Para obtener más información sobre cómo trabajar con webhooks, consulta nuestra guía de inicio rápido de webhooks.

Cómo funciona

Cuando un contacto realiza una acción específica en Mailchimp, como alcanzar un determinado punto en el recorrido del cliente o actualizar un perfil, un webhook activa un evento en una aplicación de terceros. El webhook envía una solicitud HTTP a una URL con instrucciones y detalles sobre el evento. La aplicación o integración que monitoriza esa URL envía entonces un mensaje de texto al contacto o realiza alguna otra acción en una aplicación de terceros.

Definiciones

Estos son algunos términos que encontrarás al trabajar con los webhooks en Mailchimp.

• Webhooks
  Un webhook es una solicitud HTTP que permite el envío de información entre aplicaciones.

• Encabezados
  Los encabezados describen algo sobre la solicitud. Los encabezados pueden incluir cualquier información que la aplicación receptora necesite para procesar la solicitud. Muchas aplicaciones solicitan que los encabezados contengan un tipo de clave ("Clave") y un valor de clave ("Valor").

• tipo de contenido
  La opción tipo de contenido te permite elegir el lenguaje de programación para el cuerpo de la solicitud. Actualmente, el editor solo acepta JSON y FormData.

• Carga útil
  La carga útil es el cuerpo de la solicitud. El formato correcto del cuerpo lo determina la aplicación conectada al webhook.

Webhooks como punto de recorrido del cliente

El recorrido del cliente se compone de puntos de partida específicos, acciones y reglas establecidas en función de tus objetivos de marketing. Para construir tu recorrido, selecciona y organiza estos elementos en un mapa de recorrido.

Así es como se añade un webhook como punto de recorrido del cliente.

1. Haz clic en Automations (Automatizaciones)y, a continuación, en All journeys (Todos los recorridos).
   
2. Pulsa el botón Create Journey (Crear recorrido) o pulsa en Finish Setup (Finalizar configuración) junto a un recorrido existente.
3. Para añadir un punto de recorrido, pasa el ratón por encima del icono más (+) en el paso en el que quieres que se produzca el webhook.
4. A continuación, haz clic en Add a journey point (Añadir un punto de recorrido).
   

5. Haz clic en Webhook.
   

6. En el módulo del creador de webhooks, rellena los campos para configurar tu webhook. Los campos Webhook name (Nombre del webhook), URL destination (Destino de URL), Username (Nombre de usuario)y Password (Contraseña) son obligatorios.

7. Una vez que hayas configurado tu webhook, haz clic en Save (Guardar) para añadirlo como punto de recorrido.

¡Buen trabajo! Cuando inicies o reanudes tu recorrido, el webhook se activará una vez que el usuario llegue a ese punto del recorrido. El número de solicitudes enviadas aparecerá en el propio punto de recorrido.

Webhooks como puntos de contacto del gestor de campañas

El gestor de campañas de Mailchimp es un planificador de campañas integral. Permite establecer un objetivo y luego organizar tareas, eventos, correos electrónicos y webhooks desde un planificador centralizado.

Para añadir un webhook como punto de contacto del gestor de campañas, sigue estos pasos:

1. Haz clic en Campaigns (Campañas) y luego en Campaign Manager (Gestor de campañas).
   

2. Haz clic en el botón Create campaign (Crear campaña) o en la campaña activa a la que deseas añadir un punto de contacto de webhook.

3. Haz clic en el menú desplegable Add touchpoint (Añadir punto de contacto) y luego en Webhook.

4. En el módulo del creador de webhooks, rellena los campos para configurar y programar tu webhook.

   Se utilizará de forma predeterminada el público que hayas seleccionado durante la configuración de la campaña. Si no quieres activar una acción de webhook para todo tu público, selecciona un segmento o etiqueta existente de tu público en la sección Segment or Tag (Segmento o etiqueta) del módulo.

5. Una vez que hayas configurado tu webhook y establecido una fecha y hora, haz clic en Schedule webhook (Programar webhook) para añadirlo como punto de contacto de la campaña.

¡Excelente! Puedes ver el punto de contacto webhook en tu calendario y, cuando hayan transcurrido la fecha y hora programadas, se mostrará como completado.

Configuración del webhook del público

Para enviar actualizaciones sobre tu público a otra aplicación, puedes configurar un webhook de público. Los webhooks pueden enviar una solicitud a la URL que elijas cuando se produzcan actualizaciones específicas en el público, como cuando alguien se suscribe o cuando se actualiza un perfil.

A continuación, te explicamos cómo añadir un webhook a tu público.

1. Haz clic en Audience (Público) y luego en Audience dashboard (Panel de control de público).
   
2. Si tienes más de un público, haz clic en el menú desplegable Current audience (Público actual) y selecciona con cuál quieres trabajar.
3. Haz clic en el menú desplegable Manage Audience (Gestionar público) y selecciona Signup forms (Formularios de suscripción).

4. Haz clic en Webhooks.
   

5. Haz clic en Create New Webhook (Crear nuevo webhook).

6. Introduce una URL de devolución. Esta es la URL a la que el webhook envia las solicitudes.

7. Marca todas las acciones que quieras que activen un webhook. Estas son las opciones disponibles:

   • Subscribes (Suscripciones)
   • Unsubscribes (Cancelaciones de suscripción)
   • Profile updates (Información de perfil actualizado)
   • Cleaned address (Dirección limpia)
   • Email changed (Correo electrónico cambiado)
   • Campaign sending (Envío de campañas)

8. También puedes elegir enviar actualizaciones solo cuando un suscriptor, un administrador de cuenta o a través de la API realice un cambio.

9. Haz clic en Save (Guardar).

¡Ya está! Cuando se produce una de las acciones seleccionadas, el webhook enviará una solicitud a la URL que has introducido.