Clerk
Los usuarios, la lista de espera y los inicios de sesión de Clerk se convierten en contactos y eventos, con firma Svix.
Con la integración de Clerk, cada usuario se convierte en contacto, la lista de espera también, y el registro, la actualización, la eliminación y (si quieres) cada inicio de sesión se convierten en eventos.
#Crea la conexión
En el panel, abre Integraciones › Tu app y haz clic en Conectar en la tarjeta de Clerk. La conexión tiene tu URL, que pegas en el proveedor, y muestra el paso a paso en la propia pantalla.
https://api.postal.so/integrations/crm/01a1c2d3-e4f5-7a6b-8c9d-0e1f2a3b4c5d/webhookEn Clerk, abre Configure › Webhooks, haz clic en Add Endpoint, pega la URL y suscríbete a los eventos de la tabla. En la página del endpoint, revela el Signing Secret (whsec_…) y pégalo en la conexión.
Cómo comprueba Postal
Clerk firma con Standard Webhooks (Svix): los encabezados svix-id, svix-timestamp y svix-signature, con un máximo de 5 minutos.
Las integraciones de app cuentan en el límite del plan (app_integrations). Fuera del plan, las tarjetas aparecen bloqueadas con el botón Mejorar plan.
#Eventos
| Evento de Clerk | Evento en Postal | Contacto |
|---|---|---|
user.created | clerk.user.created | Creado con el correo electrónico principal, el nombre y el apellido; el ID de Clerk pasa a ser external_id. |
user.updated | clerk.user.updated | Actualizado por el ID de Clerk (incluido el cambio de correo electrónico). |
user.deleted | clerk.user.deleted (eliminación) | Por el ID de Clerk; nunca crea un contacto. |
waitlistEntry.created, waitlistEntry.updated | clerk.waitlistEntry.created, …updated | Solo con el correo electrónico. Cuando la persona se convierte en usuario, el ID se incorpora al mismo contacto. |
session.created (desactivado por defecto) | clerk.session.created | Un inicio de sesión: solo actualiza contactos que ya existen. |
Para las eliminaciones, la conexión indica qué hacer con el contacto: solo registrar el evento (predeterminado), dar de baja al contacto (sigue en la audiencia, sin recibir marketing) o eliminar el contacto (sin evento, ya que el contacto desaparece). Una eliminación nunca crea un contacto que Postal no tenía.
#Configuración de la conexión
- Eventos: solo los marcados se convierten en contacto y evento; los demás se ignoran (la respuesta sigue siendo
202). - Sincronizar el nombre: actualiza el nombre y el apellido del contacto con lo que llegue del proveedor.
- Añadir al segmento y Suscribir al tema: un segmento estático y un tema para cada contacto que llega.
- Cuando el usuario se elimine en la app: solo registrar, dar de baja o eliminar el contacto.
Todo lo que la conexión cambia en el contacto lleva el origen crm:<id da conexão> (last_change_source), y cada entrega aparece en el registro de la conexión, con el resultado de cada persona. Una entrega repetida por el proveedor (mismo ID) no se procesa dos veces.
#Dispara automatizaciones
Cada evento queda en el contacto con el nombre clerk.user.created y las propiedades de la tabla anterior. En la pantalla de la conexión, el botón Crear automatización junto a cada evento abre una automatización nueva con el disparador Evento recibido ya rellenado. Con los endpoints de automatizaciones, el disparador es {"type": "event", "event": "clerk.user.created"}.
Ejemplo: bienvenida al registrarse y, para la lista de espera, un correo electrónico de “ya estás en la lista” con el segmento “Lista de espera” elegido en la conexión. En los correos electrónicos, las propiedades del evento entran como {{event.amount}} en los pasos o como variables de la plantilla ({{{amount}}}).
#Probar
En el endpoint de Clerk, la pestaña Testing envía un ejemplo de user.created. La respuesta de Postal aparece en Message Attempts, y el contacto, en la audiencia.