A maior parte do trabalho de email marketing acontece dentro do painel do arrobaMail, sem escrever uma linha de código. Mas alguns negócios precisam que a plataforma converse com seus próprios sistemas: que uma compra na loja cadastre um contato, que um cadastro em um app dispare uma boas-vindas, ou que um assistente de IA consulte suas campanhas por você.
Este guia é uma orientação: explica de forma simples quais são os caminhos para integrar, quando cada um vale a pena e para onde ir para o detalhe técnico. A parte de programação vive nas seções especializadas —pensadas para sua equipe técnica ou seu desenvolvedor—.
Dica: se você não precisa conectar o arrobaMail com outro sistema, pode pular esta seção sem perder nada. Tudo o que é essencial no dia a dia se faz pelo painel.
Vale a pena integrar?
Faz sentido conectar o arrobaMail com seus sistemas quando:
- Um e-commerce ou CRM precisa criar ou atualizar assinantes em tempo real.
- Você quer disparar e-mails automáticos a partir de eventos que ocorrem fora da plataforma (uma compra, um cadastro, um pagamento).
- Sua equipe monta painéis próprios com as métricas das suas campanhas.
- Você trabalha com um assistente de IA (como Claude ou Cursor) e quer operar sua conta a partir dali.
Existem quatro caminhos, e você escolhe conforme o caso. Todos partem do mesmo lugar: o panorama de integração.
1. A API: conectar seus sistemas por código
A API v3 permite que outros sistemas operem o arrobaMail de forma automática: cadastrar assinantes, criar campanhas, consultar estatísticas ou ativar fluxos, sem entrar no painel. É o caminho para integrações sob medida montadas por um desenvolvedor.
Cobre a gestão de listas, campanhas, segmentações, remetentes e automações. Para entender o panorama e os casos de uso, está API REST v3 para desenvolvedores; para o detalhe de cada operação disponível, a referência técnica completa.
2. Webhooks: um evento externo disparando um fluxo
Um webhook é uma via para que seu sistema avise o arrobaMail quando algo importante acontece: um cliente concluiu uma compra, alguém se cadastrou, um pagamento foi recusado. Esse aviso pode iniciar uma automação, adicionar uma tag ou enviar um e-mail na hora, sem intervenção manual.
É o que conecta sua loja ou seu app com as automações. Como configurar está dentro da seção de integração.
3. Envios transacionais: os e-mails um a um
Os transacionais são e-mails individuais disparados por uma ação concreta: uma confirmação de compra, uma redefinição de senha, um comprovante. Não são campanhas comerciais; chegam a uma única pessoa em resposta a algo que ela fez.
Vale enviá-los a partir de um endereço separado do das suas campanhas, para proteger a reputação dos dois canais. O detalhe de implementação é tratado junto com a API.
4. MCP: operar sua conta com um assistente de IA
Se você usa um assistente de IA como Claude, Cursor, VS Code ou Windsurf, pode conectá-lo ao arrobaMail por MCP (um padrão aberto) e pedir coisas em linguagem natural: "mostre o status das minhas últimas campanhas", "adicione estes contatos à lista". O assistente consulta sua conta em tempo real e responde a você —sem escrever código—.
É o caminho mais acessível para tarefas frequentes de consulta e gestão assistida. Tudo está em MCP: arrobaMail para assistentes de IA.
Qual escolher
| Caminho | Para quem | Como se usa | Onde aprofundar |
|---|---|---|---|
| API v3 | Desenvolvedores | Código (integrações sob medida) | /api · /api/referencia |
| Webhooks | Equipes técnicas | Eventos externos que disparam fluxos | /integracion |
| Transacional | Equipes técnicas | E-mails um a um a partir do seu sistema | /api |
| MCP | Qualquer usuário com um assistente de IA | Linguagem natural a partir do Claude, Cursor… | /mcp |
Importante: para criar campanhas ou enviar e-mails a partir de qualquer integração, o remetente que você usar precisa estar verificado e certificado na conta. Se não estiver, o envio não é executado. Revise a verificação de remetente se for preciso.
Não sabe por onde começar? O panorama de integração reúne os quatro caminhos e ajuda você a escolher conforme o seu caso.