mailinapp
Documentation menu

Zapier e automação de CRM

O MailInApp ainda não tem um aplicativo oficial no Zapier, mas você não precisa de um. O webhook do projeto já é um JSON simples e assinado sobre HTTPS, exatamente o que o gatilho genérico Webhooks by Zapier espera. Aponte-o para qualquer Zap e cada interação — voto de enquete, envio de formulário, resultado de quiz, compra de produto — chega ao seu CRM, uma planilha, o Slack, ou qualquer outro lugar que o Zapier alcance, sem nenhum código.

A mesma abordagem funciona para Make, n8n, Pipedream, ou qualquer outra ferramenta de automação que consiga capturar um webhook de entrada — este guia usa o Zapier porque é o mais solicitado.

Configure

  1. No Zapier, crie um novo Zap e escolha Webhooks by Zapier como o aplicativo de gatilho, com o evento Catch Hook.
  2. O Zapier te dá uma Catch Hook URL única — copie-a.
  3. No MailInApp, abra Dashboard → seu e-mail → Respostas, cole essa URL no campo Webhook, e clique em Ativar.
  4. Copie o segredo de assinatura que o MailInApp te mostra (whsec_…) — você só vai vê-lo uma vez. Você não precisa dele para os Zaps mais simples, mas guarde-o em um lugar seguro se planeja verificar assinaturas mais tarde.
  5. Dispare uma interação real — vote em uma enquete, envie um formulário, ou use o envio de teste do projeto — depois clique em Test trigger de volta no Zapier. Ele deve mostrar o payload que o MailInApp acabou de enviar, com campos como event.action, event.value, e recipient.row.
  6. Adicione a etapa de ação que quiser — "Create row in Google Sheets", "Create record in HubSpot/Salesforce/Airtable", "Send Slack message", e assim por diante — mapeando os campos que você precisa a partir do payload capturado.
  7. Ative o Zap.

É isso — toda interação futura naquele projeto flui automaticamente. Todo campo disponível para mapeamento está documentado na referência do payload do webhook.

Filtrando o que importa

A maioria dos casos de uso de CRM só se importa com algumas interações — um formulário concluído, não toda abertura. Adicione uma etapa Filter by Zapier logo depois do gatilho:

  • Continue somente se event.action corresponder exatamente a submit (ou vote, rate, purchase, etc.) para reagir a uma ação específica.
  • Continue somente se event.blockId corresponder exatamente ao id de um bloco específico (visível no inspetor de blocos do estúdio) para reagir a um bloco específico, ignorando os outros no mesmo projeto.
  • Continue somente se lowScore for true para construir um Zap que alerte um gestor sobre respostas ruins de CSAT/NPS — o mesmo sinal que os próprios alertas de nota baixa no app do MailInApp usam, mas roteado pela sua própria automação.

Levando contatos de volta na outra direção

A automação geralmente funciona nos dois sentidos: um ticket do helpdesk é resolvido, e você quer que essa pessoa seja adicionada a (ou atualizada em) uma lista de contatos do MailInApp para um envio de acompanhamento, sem um humano precisar reexportar um CSV. Use uma etapa de ação Webhooks by Zapier → POST como a última etapa de qualquer Zap — "ticket resolvido", "negócio fechado", "formulário enviado em outro lugar" — apontada para o endpoint de upsert de linhas da sua lista de contatos, para manter uma lista de envio do MailInApp atualizada automaticamente. Esse endpoint aceita até 500 linhas por chamada e tem limite de 30 requisições por minuto por chave de API. Isso é generoso para um Zap disparado por eventos individuais, mas vale saber se você algum dia processar um grande backfill em lote por ele.

Se uma entrega falhar

Uma URL de Zap inativa, um Zap pausado, ou uma instabilidade temporária do Zapier — tudo isso conta como uma entrega falha do lado do MailInApp. O mesmo vale para uma URL de recebimento que responde com um redirecionamento em vez de uma resposta normal — o MailInApp não segue redirecionamentos na entrega de webhooks. Uma entrega simplesmente lenta também falha: ela tem 5 segundos para responder antes de o MailInApp tratá-la como falha. As entregas são reprocessadas automaticamente com backoff, e qualquer entrega que continue falhando aparece em Entregas com falha na página de Respostas, com um botão manual de Reenviar — veja semântica de entrega para o cronograma completo de novas tentativas. Nada nunca é descartado silenciosamente: a própria interação sempre é armazenada primeiro no MailInApp, com ou sem a entrega do webhook.