Guia do painel

Integrações

Código pronto para a sua stack, conexões com CRMs e aplicativos conectados.

Para que serve

Integrações reúne três jeitos de ligar a Postal ao que você já usa: Guias de código (como enviar da sua linguagem, framework ou plataforma), CRM (sincronizar contatos com um CRM) e Seu app (cobrança e login do seu produto viram contatos e eventos).

Quando usar: Ao começar a integrar (copie o código pronto), ao ligar a base de contatos ao CRM e ao disparar automações a partir de pagamentos e cadastros do seu app.

#Guias de código

Onde fica: Desenvolvedores › Integrações. Endereço: app.postal.so/integrations.

Um catálogo de exemplos prontos, com a URL da API (https://api.postal.so) e um dos seus domínios já no código. Nenhuma chave aparece: use uma das suas Chaves de API no lugar do marcador ps_sua_chave.

Item	O que faz
Chaves de API	O botão do cabeçalho leva à lista de chaves.
Buscar por linguagem, framework ou plataforma	Filtra o catálogo (experimente Node, PHP, SMTP, webhook). Toda linguagem com HTTP funciona com a API.
Domínio do remetente	Se o time tem mais de um domínio, escolhe qual aparece nos exemplos. Sem domínio, os exemplos usam `seudominio.com.br` e a tela lembra de adicionar e verificar um domínio.
Lista da esquerda	As opções, cada uma com sua categoria: Node.js (API), Next.js (Framework), Python, PHP, Laravel, Ruby, Go, cURL (API), SMTP (SMTP), Supabase Auth, WordPress (Plataforma) e Webhooks (verificação de assinatura).
Detalhe	O nome e a categoria, uma descrição, o passo a passo numerado, e o código com abas (quando há mais de um exemplo) e o botão de copiar.

Veja também: SDKs e Laravel · SMTP · Primeiros passos · Verificar a assinatura.

#CRM

Onde fica: Desenvolvedores › Integrações › aba CRM. Endereço: app.postal.so/integrations/crm.

Mantém os contatos da Postal e as pessoas do seu CRM em sincronia, nos dois sentidos e sem loops. O que muda no CRM chega como contato, etiqueta, propriedade e evento (e pode iniciar uma automação); o que acontece na Postal (contato alterado, e-mail aberto, clicado, respondido, devolvido) volta ao CRM como dados da pessoa e nota na linha do tempo.

Item	O que faz
Suas conexões	Cada conexão com o status (Ativa, Pausada ou Com erro) e Última sincronização ... (ou Ainda não sincronizou).
Conectar um CRM	Cartões para HubSpot, Pipedrive e RD Station CRM (conexões nativas, com Conectar) e Outro CRM (webhook) (com Configurar), para qualquer sistema que envie e receba webhooks.
Limite do plano	Quando o plano não inclui conexões de CRM, ou todas já foram usadas, os cartões mostram Fazer upgrade no lugar do botão.

Conexão nativa (HubSpot, Pipedrive, RD Station CRM)

Em Conectar, cole as credenciais do CRM (token da API; no Pipedrive, também o endereço da conta; no HubSpot, opcionalmente o client secret para receber webhooks assinados). Elas ficam guardadas criptografadas e não aparecem de novo. A janela traz o Onde pegar de cada CRM.
Na página da conexão, use Testar conexão para conferir o acesso.
Em Receba do ..., copie a URL do webhook (no Pipedrive, também o usuário e a senha da autenticação HTTP) e configure o webhook no próprio CRM. Sem webhook, Sincronizar agora traz tudo quando você quiser.
Em Campos e etapas, e-mail, nome e sobrenome já são ligados sozinhos; acrescente outros campos (inclusive personalizados) e diga o que cada etapa do funil faz na Postal (uma propriedade e uma etiqueta).
Em Envie para o ..., as mudanças de contato e a atividade dos e-mails (enviado, aberto, clicado, respondido) viram dados e notas na pessoa.

Conexão por webhook (Outro CRM)

Parte	O que faz
Receba do seu CRM	A URL do webhook e o Segredo de assinatura (Gerar novo segredo troca). Assine o corpo com HMAC-SHA256 e envie em `X-Postal-Signature`. Aceitar o segredo como token serve a ferramentas que não assinam, mas é menos seguro.
Sentido da sincronização	Nos dois sentidos, Só do CRM para o Postal ou Só do Postal para o CRM.
Envie para o seu CRM	URL do seu CRM (HTTPS), O que enviar (quais eventos), Não enviar mudanças vindas de (anti-loop), Testar envio e Enviar todos os contatos.
Mapeie os campos	Cole um Exemplo do payload do seu CRM, ligue cada campo (Campo do CRM → Campo do Postal, com o Sentido de cada um), defina as etapas do funil e confira em Ver resultado do exemplo antes de salvar.

Registro de sincronização

Cada conexão tem um Registro de sincronização, com o filtro Filtrar por resultado (Sucesso, Falhou, Na fila, Ignorado) e as colunas Quando, Sentido (Recebido ou Enviado), O quê (webhook recebido, pessoa, atividade de e-mail, teste, sincronização completa), Registro no CRM e Resultado. As falhas têm o botão Reenviar. Na conexão, Pausar / Retomar interrompe sem apagar, e a exclusão apaga o registro.

Dica

Para evitar que uma mudança fique pulando de um sistema ao outro, use "Não enviar mudanças vindas de" e deixe o sentido só onde faz falta.

Veja também: Conexões de CRM · CRM por webhook · Origem das mudanças.

#Seu app (cobrança e login)

Onde fica: Desenvolvedores › Integrações › aba Seu app. Endereço: app.postal.so/integrations/apps.

Liga a cobrança e o login do seu produto à Postal: cada cadastro, pagamento ou cancelamento vira contato e evento, e os eventos disparam automações. Os e-mails de login do seu app (confirmação, link mágico, senha) também podem sair pela Postal.

Item	O que faz
Suas integrações	As conexões criadas, cada uma com Conectado, Último evento ... (ou Ainda não recebeu eventos).
Conectar uma fonte	Cartões para Stripe (clientes, assinaturas, faturas, checkout), Supabase, Clerk, Auth0 e Firebase Auth. Conectar cria a conexão e abre a página dela. Sem o recurso no plano, os cartões mostram Fora do plano e Fazer upgrade.
Como funciona	Cadastro vira contato (e-mail, nome e ID do usuário no app); cada evento fica no contato e pode iniciar uma automação; os e-mails de login podem sair pela Postal.
E-mails de login pela API	Guias, sem conexão, para Better Auth, Auth.js e Auth0 enviarem pela API da Postal (Ver guia).

A página de uma conexão

Siga os passos mostrados para a sua fonte (no painel do Stripe, do Clerk e assim por diante) usando a URL da conexão da página.
Cole o segredo (Segredo de assinatura do Stripe e do Clerk, o valor do X-Postal-Secret no Supabase e no Firebase, ou o token do Auth0) e clique em Salvar segredo. O segredo fica criptografado e nunca é mostrado de novo. Gerar novo segredo troca o atual, que para de funcionar.
Em Eventos, marque os que viram contato e evento na Postal (os outros são ignorados). Criar automação, em cada evento, já abre uma automação com aquele gatilho.
Em Contato, escolha o que muda a cada evento: Sincronizar o nome, Adicionar ao segmento, Inscrever no tópico e o que fazer Quando o usuário for excluído no app (Só registrar o evento, Descadastrar o contato ou Excluir o contato). Salvar configuração grava.

No Supabase há também E-mails de login pelo Postal: com o Send Email Hook, o Supabase entrega cada e-mail de autenticação à Postal, que envia com o seu modelo e o seu domínio (Remetente de um domínio verificado, Responder para, URL do projeto Supabase e os Modelos de cada tipo de e-mail, com Restaurar padrão). Esses e-mails contam nas cotas de envio.

Pausar / Retomar interrompe a conexão sem apagar; excluir faz o provedor receber erro ao enviar eventos. O número de integrações de app depende do plano.

Veja também: Integre seu app · Stripe · Supabase · Clerk · Auth0 · Firebase Auth.