Conecta Archie Send con tu CRM, ERP u otra herramienta con webhooks

Qué vas a lograr

Que otra herramienta (tu CRM, tu ERP, tu automatización o tu sitio web) se entere en el momento en que pasa algo en tu cuenta de Archie Send: un contacto nuevo, una baja, un rebote o una campaña que termina. Así no tienes que copiar datos a mano ni consultar cada cierto tiempo.

Antes de empezar

• Necesitas permiso para administrar usuarios en tu cuenta (si no ves Webhooks en el menú Usuarios, pídeselo a quien administra tu cuenta).
• Tu otra herramienta debe tener una dirección pública que empiece por https:// y que reciba avisos (en tu herramienta de automatización se llama “Webhook”, en tu sitio web puedes crear una ruta propia). No se aceptan direcciones locales ni internas.
• Un lugar seguro para guardar un código secreto (por ejemplo, tu gestor de contraseñas).

Pasos

1. Entra a Usuarios → Webhooks. Captura: menú Usuarios con la opción Webhooks y la lista vacía
2. Haz clic en Nuevo webhook.
3. Escribe un Nombre que te ayude a reconocerlo (por ejemplo, “CRM de ventas”).
4. Pega la Dirección (URL) que te dio tu otra herramienta.
5. Elige los eventos que quieres recibir. Por defecto vienen todos; quita los que no necesites. Captura: formulario con los eventos agrupados por Contactos, Suscripciones, Rebotes y Campañas
6. Haz clic en Guardar.
7. Se muestra tu secreto de firma. Cópialo y guárdalo ahora: no se vuelve a mostrar. Captura: ventana del secreto
8. En tu otra herramienta, configura ese secreto para verificar que los avisos vienen de Archie Send (ver “Cómo comprobar la firma”).
9. De vuelta en la lista, usa el ícono de Enviar prueba. A los pocos segundos abre el Historial del webhook: debe aparecer un aviso “Prueba de conexión” como Entregado.

Resultado esperado

En la lista, tu webhook aparece como Activo y, al pasar algo en tu cuenta, tu otra herramienta recibe un aviso. En el Historial ves cada aviso, si se entregó, cuántos intentos llevó y qué respondió tu herramienta.

Qué eventos puedes recibir

• Contactos: creado, actualizado, eliminado, bloqueado.
• Suscripciones: suscrito a una lista, se dio de baja de una lista, confirmó su suscripción (doble opt-in).
• Rebotes: rebote registrado.
• Campañas: iniciada, pausada, terminada, cancelada.

Los avisos cubren también lo que entra por importaciones, formularios públicos y acciones masivas, no solo lo que haces a mano.

Cómo comprobar la firma

Cada aviso llega con el encabezado X-Archie-Signature con la forma t=FECHA,v1=FIRMA. La firma es un HMAC-SHA256 del texto FECHA.CUERPO calculado con tu secreto. Compárala con la recibida y descarta los avisos con más de 5 minutos de antigüedad. La pantalla de Webhooks (sección “¿Cómo verifico que el aviso es de Archie Send?”) trae un ejemplo en PHP para tu sitio web.

Cada aviso trae un id único: si recibes el mismo dos veces, ignora el segundo. Los avisos pueden llegar en distinto orden.

Qué pasa si tu herramienta no responde

• Tu herramienta debe responder con un código 2xx (por ejemplo 200) en menos de 10 segundos.
• Si falla, reintentamos hasta 7 veces en unas 21 horas (a 1 minuto, 5 minutos, 30 minutos, 2 horas, 6 horas y 12 horas).
• Si un aviso agota los intentos queda como Fallido; en el Historial puedes usar Reenviar cuando tu herramienta vuelva a funcionar.
• Si tu dirección falla muchas veces seguidas durante más de una hora, el webhook se pausa solo para no seguir insistiendo. Corrige el problema y pulsa Reactivar.

Problemas frecuentes

Cuándo contactar a soporte

Si tu herramienta responde bien pero el historial sigue mostrando fallos, o si un evento que esperabas no llegó. Envía el nombre del webhook, el evento y la hora aproximada. No compartas tu secreto.