Integraciones
Código listo para tu stack, conexiones con CRM y aplicaciones conectadas.
Para qué sirve
Integraciones reúne tres formas de conectar Postal con lo que ya usas: Guías de código (cómo enviar desde tu lenguaje, framework o plataforma), CRM (sincronizar contactos con un CRM) y Tu app (la facturación y el inicio de sesión de tu producto se convierten en contactos y eventos).
Cuándo usarlo: Al empezar a integrar (copia el código listo), al conectar la base de contactos con el CRM y al disparar automatizaciones a partir de los pagos y registros de tu app.
#Guías de código
Dónde está: Desarrolladores › Integraciones. Dirección: app.postal.so/integrations.
Un catálogo de ejemplos listos, con la URL de la API (https://api.postal.so) y uno de tus dominios ya en el código. No aparece ninguna clave: usa una de tus Claves de API en lugar del marcador ps_sua_chave.
| Elemento | Qué hace |
|---|---|
| Claves de API | El botón del encabezado lleva a la lista de claves. |
| Buscar por lenguaje, framework o plataforma | Filtra el catálogo (prueba Node, PHP, SMTP, webhook). Cualquier lenguaje con HTTP funciona con la API. |
| Dominio del remitente | Si el equipo tiene más de un dominio, eliges cuál aparece en los ejemplos. Sin dominio, los ejemplos usan seudominio.com.br y la pantalla te recuerda añadir y verificar un dominio. |
| Lista de la izquierda | Las opciones, cada una con su categoría: Node.js (API), Next.js (Framework), Python, PHP, Laravel, Ruby, Go, cURL (API), SMTP (SMTP), Supabase Auth, WordPress (Plataforma) y Webhooks (verificación de firma). |
| Detalle | El nombre y la categoría, una descripción, el paso a paso numerado, y el código con pestañas (cuando hay más de un ejemplo) y el botón para copiar. |
Mira también: SDK y Laravel · SMTP · Primeros pasos · Verificar la firma.
#CRM
Dónde está: Desarrolladores › Integraciones › pestaña CRM. Dirección: app.postal.so/integrations/crm.
Mantiene los contactos de Postal y las personas de tu CRM sincronizados, en ambos sentidos y sin bucles. Lo que cambia en el CRM llega como contacto, etiqueta, propiedad y evento (y puede iniciar una automatización); lo que ocurre en Postal (contacto modificado, correo abierto, con clic, respondido o rebotado) vuelve al CRM como datos de la persona y nota en la línea de tiempo.
| Elemento | Qué hace |
|---|---|
| Tus conexiones | Cada conexión con su estado (Activa, Pausada o Con errores) y Última sincronización ... (o Aún no sincronizado). |
| Conectar un CRM | Tarjetas para HubSpot, Pipedrive y RD Station CRM (conexiones nativas, con Conectar) y Otro CRM (webhook) (con Configurar), para cualquier sistema que envíe y reciba webhooks. |
| Límite del plan | Cuando el plan no incluye conexiones de CRM, o ya las has usado todas, las tarjetas muestran Mejorar plan en lugar del botón. |
Conexión nativa (HubSpot, Pipedrive, RD Station CRM)
- En Conectar, pega las credenciales del CRM (token de API; en Pipedrive, también la dirección de la cuenta; en HubSpot, opcionalmente el client secret para recibir webhooks firmados). Se guardan cifradas y no se vuelven a mostrar. La ventana incluye Dónde encontrarlas para cada CRM.
- En la página de la conexión, usa Probar conexión para comprobar el acceso.
- En Recibir de ..., copia la URL del webhook (en Pipedrive, también el usuario y la contraseña de la autenticación HTTP) y configura el webhook en el propio CRM. Sin webhook, Sincronizar ahora trae todo cuando quieras.
- En Campos y etapas, el correo, el nombre y el apellido ya se enlazan solos; añade otros campos (incluso personalizados) e indica qué hace en Postal cada etapa del embudo (una propiedad y una etiqueta).
- En Enviar a ..., los cambios de contacto y la actividad de los correos (enviado, abierto, con clic, respondido) se convierten en datos y notas de la persona.
Conexión por webhook (Otro CRM)
| Parte | Qué hace |
|---|---|
| Recibir de tu CRM | La URL del webhook y el Secreto de firma (Generar un nuevo secreto lo reemplaza). Firma el cuerpo con HMAC-SHA256 y envíalo en X-Postal-Signature. Aceptar el secreto como token sirve para herramientas que no firman, pero es menos seguro. |
| Sentido de la sincronización | En ambos sentidos, Solo del CRM a Postal o Solo de Postal al CRM. |
| Enviar a tu CRM | URL de tu CRM (HTTPS), Qué enviar (qué eventos), No enviar los cambios que vengan de (antibucle), Probar envío y Enviar todos los contactos. |
| Mapea los campos | Pega un Payload de ejemplo de tu CRM, enlaza cada campo (Campo del CRM → Campo de Postal, con el Sentido de cada uno), define las etapas del embudo y compruébalo en Ver el resultado del ejemplo antes de guardar. |
Registro de sincronización
Cada conexión tiene un Registro de sincronización, con el filtro Filtrar por resultado (Correcto, Fallido, En cola, Omitido) y las columnas Cuándo, Sentido (Recibido o Enviado), Qué (webhook recibido, persona, actividad de correo, prueba, sincronización completa), Registro del CRM y Resultado. Los fallos tienen el botón Enviar de nuevo. En la conexión, Pausar / Reanudar la detiene sin borrarla, y al eliminarla se borra el registro.
Consejo
Para evitar que un cambio rebote de un sistema a otro, usa "No enviar los cambios que vengan de" y deja el sentido solo donde haga falta.
Mira también: Conexiones de CRM · CRM por webhook · Origen de los cambios.
#Tu app (facturación y acceso)
Dónde está: Desarrolladores › Integraciones › pestaña Tu app. Dirección: app.postal.so/integrations/apps.
Conecta la facturación y el acceso de tu producto con Postal: cada registro, pago o cancelación se convierte en contacto y evento, y los eventos activan automatizaciones. Los correos de acceso de tu app (confirmación, enlace mágico, contraseña) también pueden salir por Postal.
| Elemento | Qué hace |
|---|---|
| Tus integraciones | Las conexiones creadas, cada una con Conectado, Último evento ... (o Aún no se han recibido eventos). |
| Conectar una fuente | Tarjetas para Stripe (clientes, suscripciones, facturas, checkout), Supabase, Clerk, Auth0 y Firebase Auth. Conectar crea la conexión y abre su página. Si el plan no incluye la función, las tarjetas muestran No incluido en tu plan y Mejorar plan. |
| Cómo funciona | Un registro se convierte en contacto (correo, nombre e ID del usuario en la app); cada evento se guarda en el contacto y puede iniciar una automatización; los correos de acceso pueden salir por Postal. |
| Correos de acceso mediante la API | Guías, sin conexión, para que Better Auth, Auth.js y Auth0 envíen mediante la API de Postal (Leer la guía). |
La página de una conexión
- Sigue los pasos que se muestran para tu fuente (en el panel de Stripe, de Clerk, etc.) usando la URL de la conexión de la página.
- Pega el secreto (el Secreto de firma de Stripe y de Clerk, el valor de
X-Postal-Secreten Supabase y en Firebase, o el token de Auth0) y haz clic en Guardar secreto. El secreto se guarda cifrado y no se vuelve a mostrar. Generar un nuevo secreto reemplaza el actual, que deja de funcionar. - En Eventos, marca los que se convierten en contacto y evento en Postal (los demás se ignoran). Crear automatización, en cada evento, abre directamente una automatización con ese disparador.
- En Contacto, elige qué cambia con cada evento: Sincronizar el nombre, Añadir al segmento, Suscribir al tema y qué hacer Cuando el usuario se elimina en la app (Solo registrar el evento, Cancelar la suscripción del contacto o Eliminar el contacto). Guardar configuración lo guarda.
En Supabase también hay Correos de acceso mediante Postal: con el Send Email Hook, Supabase entrega cada correo de autenticación a Postal, que lo envía con tu plantilla y tu dominio (Remitente de un dominio verificado, Responder a, URL del proyecto de Supabase y las Plantillas de cada tipo de correo, con Restaurar valor predeterminado). Estos correos cuentan para las cuotas de envío.
Pausar / Reanudar detiene la conexión sin borrarla; si la eliminas, el proveedor recibirá un error al enviar eventos. El número de integraciones de app depende del plan.
Mira también: Integra tu app · Stripe · Supabase · Clerk · Auth0 · Firebase Auth.