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
No n8n, vá em Settings → Community Nodes → Install e digite n8n-nodes-mailinapp. Os detalhes estão no guia de nós da comunidade do n8n.
Você já pode instalar em um n8n auto-hospedado. O n8n Cloud só oferece nós da comunidade verificados pelo n8n, e este pacote ainda não foi verificado. Ele segue as regras de verificação do n8n, então chega ao Cloud assim que o n8n aprovar.
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 doze 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 e Journey 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. |
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.