API do Postmark: o que dá para fazer e como usar com agentes de IA
O Postmark é um serviço de envio de e-mails transacionais, como confirmações, recuperação de senha e notificações. Sua API permite enviar e-mails, usar templates, acompanhar entregas e devoluções e processar e-mails recebidos. É usado por times de produto e engenharia que precisam de alta entregabilidade.
Os grandes recursos da API, em português claro.
Envio individual ou em lote por API.
Modelos com variáveis para mensagens recorrentes.
Consulta de devoluções e reativação de endereços.
Histórico de envios, aberturas e cliques.
Recebimento e processamento de e-mails enviados ao seu endereço.
Eventos de entrega, devolução, abertura e reclamação de spam.
Como se acessa a API do Postmark.
- Com credencial da sua empresaUsa token de servidor para envio e consultas de um servidor e token de conta para administração, enviados no cabeçalho das requisições.
- Documentação oficialpostmarkapp.com/developer
- O Postmark separa fluxos transacionais e de broadcast; não misture marketing no transacional.
- Altas taxas de devolução ou spam podem levar a bloqueio da conta.
- E-mails contêm dados pessoais: defina retenção do histórico.
- api postmark
- postmark api documentação
- postmark email api
- postmark webhook
- postmark inbound
- integração postmark
O que um agente do iTeam faz com a API do Postmark.
Quando o cliente diz que não recebeu o e-mail, o agente de suporte consulta o histórico no Postmark e explica se houve devolução ou filtro.
O agente lista devoluções definitivas e atualiza o cadastro do cliente pedindo um e-mail válido.
E-mails que chegam pelo inbound são lidos pelo agente, classificados e direcionados ao time certo.
O agente acompanha taxas de devolução e spam e alerta quando passam do limite.
Da credencial ao agente trabalhando, com aprovação.
Crie o servidor e o token
No Postmark, use o servidor e o fluxo de mensagens certos e copie o token do servidor.
Cadastre no cofre do iTeam
O token fica no cofre; o agente envia apenas os templates aprovados e consulta o histórico.
Teste com endereços internos
Envie para caixas internas, confira templates e webhooks e só depois libere para clientes.
Dúvidas sobre a API do Postmark.
A API do Postmark é gratuita?
O Postmark oferece um volume pequeno para testes e cobra planos por quantidade de e-mails; a API faz parte do serviço.
Preciso programar para usar a API do Postmark com o iTeam?
Não necessariamente. O iTeam lê a documentação e o time de implantação configura templates e eventos.
O Postmark serve para newsletter?
O Postmark tem fluxo próprio para broadcast, separado do transacional; o uso deve seguir as regras deles.
Qual a diferença entre token de servidor e token de conta no Postmark?
O token de servidor, enviado no cabeçalho, envia e consulta e-mails de um servidor específico. O token de conta administra servidores, domínios e assinaturas, e só proprietários e administradores o acessam. O agente de envio usa o de servidor.
O Postmark tem modo de teste que não entrega e-mail de verdade?
Sim: usar o token de teste do Postmark no lugar do token real valida a requisição sem entregar a mensagem ao destinatário. Serve para testar a integração com segurança antes de apontar o agente para o servidor de produção. Confira os detalhes na documentação oficial.
O Postmark serve para o agente enviar e-mails de marketing?
Não é o foco: o Postmark separa o fluxo transacional do de broadcast, e misturar marketing no transacional prejudica a entregabilidade. Use-o para confirmações, avisos e recuperação de senha, e deixe newsletters para uma ferramenta de e-mail marketing.
O que acontece com altas taxas de devolução ou spam no Postmark?
Taxas altas de bounce ou de reclamação de spam podem levar ao bloqueio da conta. O agente deve enviar só para endereços válidos e consentidos, e a API de bounces ajuda a retirar da lista quem devolveu.
O agente pode processar e-mails recebidos pelo Postmark?
Sim, o recurso inbound transforma e-mails recebidos em chamadas de webhook com o conteúdo. O agente lê, entende o pedido e responde ou abre um chamado, passando para uma pessoa o que for sensível ou exigir decisão.
Por quanto tempo o Postmark guarda o histórico de mensagens?
Não tenho o prazo atual confirmado; confira em postmarkapp.com/developer. Como e-mails contêm dados pessoais, defina a retenção do histórico e o que o agente pode consultar, para não manter conteúdo de clientes além do necessário. Isso reduz o risco com a LGPD.
Posso usar templates do Postmark com o agente de IA?
Sim, a API envia e-mails com templates. O agente preenche as variáveis, como nome e número do pedido, e o texto fixo fica aprovado pela empresa, o que evita improviso no conteúdo de mensagens como confirmação de compra. A equipe de produto mantém os templates.
Quando o Postmark não é a melhor escolha para um agente de IA?
Se o envio é de newsletter ou de campanhas em massa, uma ferramenta de e-mail marketing é mais adequada. O Postmark é pensado para mensagens transacionais de alta entregabilidade, e fugir desse perfil arrisca a reputação do domínio.
