Zapier

Conecte o MailInApp aos milhares de apps do Zapier: mande leads novos para uma planilha, publique reuniões agendadas no Slack, abra um registro no CRM quando um negócio é ganho, ou adicione um contato ao MailInApp quando algo acontece em outro lugar.

O app do MailInApp para Zapier

O app oficial do MailInApp para Zapier está em análise pelo Zapier e ainda não aparece no diretório de apps dele. Quando estiver disponível, você vai conectá-lo com uma chave de API e escolher gatilhos e ações em menus, sem copiar URLs:

• Gatilhos: um para cada evento da conta, incluindo New Lead, Lead Turned Hot, Meeting Booked, Deal Stage Changed, Form Submitted, Purchase Completed e Journey Completed.
• Ações: Create or Update Contact, Trigger Journey, Create Deal, Update or Move Deal e Send Transactional Email.
• Busca: Find Contact, que se combina com a criação como «Find or Create Contact».

Esta página vai apontar para a página do app assim que ele for publicado. Até lá, tudo o que está abaixo já funciona hoje com o app nativo Webhooks by Zapier.

Enviar eventos do MailInApp para um Zap

1. No Zapier, crie um Zap com Webhooks by Zapier como gatilho e Catch Hook como evento. Copie a URL que o Zapier fornecer.
2. No MailInApp, vá em Desenvolvedores → Webhooks. Cole a URL como URL do endpoint, marque os eventos que este Zap deve receber e clique em Adicionar webhook. Guarde o segredo de assinatura se você pretende verificar as assinaturas depois.
3. Clique em Enviar teste no webhook novo e depois em Test trigger no Zapier. Você verá o evento de exemplo, com o type e cada campo de data, como o e-mail do contato ou a etapa do negócio.
4. Adicione as etapas de ação, mapeie os campos de que precisa e ative o Zap.

Todo evento tem o mesmo formato: um id, um type, uma data createdAt e um objeto data. A página de webhooks lista cada evento e os seus campos. Se um mesmo Catch Hook receber vários tipos de evento, adicione uma etapa Filter by Zapier sobre type, ou crie um webhook por Zap.

Quer só as interações de um e-mail, como cada resposta a uma pesquisa específica? Cole a URL do Catch Hook no webhook do projeto desse e-mail, na página Respostas dele.

Agir no MailInApp a partir de um Zap

Use uma ação Webhooks by Zapier → Custom Request para chamar a API do MailInApp com a sua chave de API em um cabeçalho Authorization: Bearer mia_live_…. Por exemplo:

• Adicionar ou atualizar um contato quando alguém preenche um formulário em outro lugar: POST /api/v1/contacts.
• Abrir um negócio quando um lead agenda uma conversa em outra ferramenta: POST /api/v1/deals. Defina um cabeçalho Idempotency-Key, como o identificador do registro na outra ferramenta, para que uma nova tentativa do Zap não crie um segundo negócio.
• Inscrever um contato em uma jornada cujo gatilho é Chamada de API: POST /api/v1/journeys/{id}/trigger.
• Enviar um recibo ou uma notificação: POST /api/v1/send com "type": "transactional". Não envie e-mail de marketing a partir de um Zap: um Zap não consegue provar que o destinatário concordou.

Quando uma entrega falha

Um Zap pausado ou excluído, ou uma instabilidade do Zapier, conta como entrega com falha. O MailInApp tenta de novo automaticamente por várias horas. O evento é sempre salvo primeiro no MailInApp, então nada se perde do lado do MailInApp.