n8n
Os nós do MailInApp para o n8n iniciam fluxos quando algo acontece no MailInApp e permitem que fluxos adicionem contatos, movam negócios, inscrevam contatos em jornadas e enviem e-mails transacionais. Eles estão publicados no npm como n8n-nodes-mailinapp.
Instalar
O n8n verificou os nós do MailInApp. No n8n Cloud, um proprietário ou administrador da instância abre o painel de nós na tela, busca MailInApp, escolhe o item em More from the community e seleciona Install. Depois disso, todos na instância podem usar.
Em um n8n auto-hospedado, vá em Settings → Community Nodes → Install e digite n8n-nodes-mailinapp. Veja o guia de nós da comunidade do n8n para mais detalhes.
Conectar a sua conta
- No MailInApp, vá em Desenvolvedores e crie uma chave de API. Ela começa com
mia_live_e só aparece uma vez. - No n8n, crie uma credencial MailInApp API e cole a chave. Deixe Base URL como
https://mailinapp.com.
A chave age em nome de toda a sua conta do MailInApp, então trate-a como uma senha. Revogá-la no MailInApp também desliga todos os gatilhos que ela configurou.
O nó MailInApp Trigger
Escolha um ou mais eventos. Quando você ativa o fluxo, o nó os assina no MailInApp. Quando desativa, a assinatura é removida. Você vê essas assinaturas em Desenvolvedores → Webhooks, marcadas como n8n.
Os eventos são os quinze eventos da conta: Interaction Received, Form Submitted, Contact Created, Contact Updated, Lead Turned Hot, New Lead, Meeting Booked, Meeting Cancelled, Deal Created, Deal Stage Changed, Purchase Completed, Journey Completed, Experiment Decided, Experiment Results Ready e Response Completed.
Cada execução recebe o evento como o MailInApp o enviou, com id, type, createdAt e data. O id é o mesmo em cada entrega de um mesmo evento, então você pode usá-lo para descartar duplicados. Toda entrega é assinada. O nó recusa qualquer requisição sem assinatura válida ou com timestamp de mais de 5 minutos atrás: conhecer a URL do webhook não basta para iniciar o seu fluxo.
O nó MailInApp
| Recurso | Operações |
|---|---|
| Contact | Create or Update um endereço em uma lista de contatos. O MailInApp o verifica ao salvar. Get devolve o contato do endereço em cada lista, ou em uma. |
| Contacts List | Get Many listas com seus campos e número de contatos. |
| Deal | Create um negócio para um contato, pelo e-mail. Defina uma Idempotency Key (um número de pedido, por exemplo) para que uma execução repetida não crie um segundo negócio. Update um negócio: movê-lo para outra etapa, incluindo ganho e perdido, ou mudar título, valor ou moeda. Get Many negócios, os movidos mais recentemente primeiro, filtrados por e-mail do contato, status ou pipeline: encontre o negócio de um contato e depois atualize-o. |
Send Transactional: o seu próprio assunto e HTML ou texto, ou um projeto do estúdio com dados de mesclagem. Um envio com falha é um erro. Um resultado suppressed (o endereço deu bounce ou é inválido) é um resultado normal, que você pode usar para ramificar. | |
| Journey | Enroll Contact em uma jornada cujo gatilho é Chamada de API, e Get Many jornadas. |
| Pipeline | Get Many pipelines com as suas etapas. |
As listas suspensas mostram as suas listas, campos de lista, jornadas, pipelines e etapas. O nó suporta o Continue On Fail do n8n.
E-mail de marketing não é oferecido: um fluxo não consegue provar que o destinatário concordou. Envie o marketing pelo MailInApp, ou inscreva o contato em uma jornada.
Com um agente de IA
O nó MailInApp pode ser usado como ferramenta pelo AI Agent do n8n. Para ter mais ferramentas, conecte também o agente ao servidor MCP do MailInApp com um nó MCP Client Tool: endpoint https://mailinapp.com/api/mcp, com a sua chave de API como credencial Bearer.
O pacote traz um fluxo de exemplo pronto (examples/ai-agent-mcp.workflow.json dentro do pacote). O agente dele pode ler contatos, resultados, respostas de formulários, segmentos e jornadas, e esboçar jornadas novas, mas não tem nenhuma ferramenta que envie e-mail. Jornadas montadas por um agente são sempre salvas desligadas, para que uma pessoa as revise e ative.
Sem os nós
Qualquer fluxo do n8n também pode usar o MailInApp pelo gatilho genérico Webhook, alimentado por um webhook que você adiciona em Desenvolvedores → Webhooks, e pelo nó HTTP Request chamando a API.
