O Zapier conecta o Notifuse a milhares de outros aplicativos sem código. O Notifuse oferece gatilhos e ações:
- Os gatilhos iniciam um Zap quando algo acontece no Notifuse: um contato é criado ou atualizado, alguém se inscreve em uma lista ou cancela a inscrição, um contato entra em um segmento ou sai dele. O Notifuse envia cada evento ao Zapier no momento em que ele acontece; o Zapier não fica consultando.
- As ações permitem que outro app atue no Notifuse. A principal é o envio: um Zap escolhe uma das suas notificações transacionais e o Notifuse a envia com o seu template, o seu remetente e o seu provedor de email. As ações também podem criar ou atualizar um contato, ou inscrever um contato em uma lista.
Antes de começar
Você precisa de uma Chave API e da URL da API do Notifuse. Conectar o Zapier em Configurações → Integrações fornece as duas.
Você também precisa de HTTPS: o Zapier só chama endpoints servidos por HTTPS com um certificado de uma autoridade certificadora pública, e uma instância self-hosted precisa estar acessível pela internet pública.
Etapa 1: conecte o Zapier
Abra Configurações → Integrações no workspace em que o Zapier vai trabalhar. Clique em Adicionar integração e escolha Zapier em Apps conectados. Só o proprietário do workspace pode fazer a conexão.
O único campo é um rótulo. Ele dá nome à conexão no Notifuse, e nada mais depende dele. Um workspace pode ter várias conexões com o Zapier, então use o rótulo para dizer para que serve cada uma. O valor padrão, “Zapier”, basta se você só precisa de uma.
Clique em Conectar o Zapier. O Notifuse gera uma chave API só com as permissões de que esta integração precisa: leitura e escrita em Transacional, Assinaturas de Webhook, Contatos e Listas, mais leitura em Segmentos. Você não precisa marcar nada.
Repare em Transacional antes de conectar. Essa permissão deixa um Zap enviar emails, e também permite criar, editar e excluir notificações transacionais, testar templates e provedores, e retransmitir pela ponte SMTP. Um token vazado poderia enviar emails pelo seu provedor, por sua conta e contra a sua reputação de envio, embora não consiga ler o seu histórico de mensagens. Se uma conexão com o Zapier não precisa enviar, restrinja a chave (veja Gerenciar a conexão depois).
O token aparece uma única vez, no painel que substitui o formulário. Copie-o antes de clicar em Concluído: nenhuma tela do Notifuse consegue mostrá-lo de novo. O mesmo painel exibe a URL da API para a etapa 2, com um botão de copiar.
Nota
O Notifuse deriva o endereço da chave a partir do seu rótulo. Ele monta o endereço como zapier-<label>-<random>, passando o rótulo para minúsculas e trocando por um hífen tudo o que não for letra, dígito ou sublinhado, ou como zapier-<random> se você manteve o valor padrão. Os endereços de chaves API são únicos em toda a instalação do Notifuse, e não por workspace. A parte aleatória permite que dois workspaces conectem cada um um Zapier “Marketing” sem conflito, e você nunca precisa procurar um nome livre. O painel de conexão mostra o endereço resultante, e o card da conexão também o mostra depois: é assim que você associa um card à sua linha em Configurações → Equipe e chaves API.
Nota
Ou crie a chave manualmente em Configurações → Equipe e chaves API → Nova chave, onde você mesmo concede as permissões (a tabela abaixo diz o que marcar). Essa chave é uma chave API comum, sem conexão associada: nenhum card aparece em Configurações → Integrações, e só remover a linha dela em Configurações → Equipe e chaves API a revoga. Dê ao Zapier uma chave própria em vez de reaproveitar outra. Administradores e chaves API tem a referência completa das permissões.
O que a chave pode fazer
Ao conectar o Zapier, tudo isso é concedido automaticamente. A tabela mostra o que o token nas mãos do Zapier consegue acessar, e o que marcar se você montar a chave manualmente em Configurações → Equipe e chaves API ou restringir uma depois.
| O que você quer usar | Permissões de que a chave precisa |
|---|---|
| Conectar a conta, o seletor de workspace e os rótulos dos campos personalizados em uma ação | Nenhuma: qualquer chave faz isso |
| Qualquer gatilho (ligar e desligar um Zap) | Leitura e escrita em Assinaturas de Webhook |
| Os dados de exemplo de qualquer gatilho (o que o Zapier mostra enquanto você monta um Zap) | Leitura em Contatos |
| Gatilhos de contato | Leitura em Contatos |
| Gatilhos de lista e o seletor de listas | Leitura em Listas e leitura em Contatos |
| Gatilhos de segmento e o seletor de segmentos | Leitura em Segmentos e leitura em Contatos |
| A ação Send Transactional Email e o seletor de notificações | Leitura e escrita em Transacional |
| Salvar no contato os campos de contato preenchidos em um envio | Escrita em Contatos. Sem ela o envio funciona, mas só o endereço é registrado |
| CC ou BCC em um envio | Leitura em Contatos também, porque o assunto é renderizado com os dados do contato |
| A ação Create or Update Contact | Escrita em Contatos |
| A ação Subscribe Contact to List | Leitura e escrita em Listas |
Nota
A leitura preenche as listas suspensas; a escrita executa a etapa. Todo seletor lê os itens entre os quais você escolhe, então só com escrita não dá para configurar uma ação. Com escrita em Listas mas sem leitura em Listas, a etapa Subscribe Contact to List não pode ser salva: o seletor de listas retorna um erro de permissão, e a lista é um campo obrigatório.
Todo gatilho precisa de leitura em Contatos, e não só os de contato: os registros de exemplo que o Zapier mostra enquanto você monta um Zap vêm dos seus contatos, qualquer que seja o gatilho escolhido. Uma chave sem essa permissão preenche as listas suspensas, mas falha em Test trigger.
Atenção
Escrita em Transacional, escrita em Assinaturas de Webhook e escrita em Listas vão mais longe do que os nomes sugerem. A escrita em Transacional envia emails pelo seu provedor, e também permite editar e excluir as suas notificações transacionais, testar provedores e usar a ponte SMTP. Um gatilho assina eventos e faz com que os payloads deles sejam entregues ao Zapier. Inscrever um endereço em uma lista cria ou sobrescreve o registro desse contato, e enviar para ele também. Proteja esta chave como você protegeria a sua base de contatos e as suas credenciais de envio.
Etapa 2: a sua URL da API
O formulário de conexão do Zapier tem um campo API URL. O painel Conectar o Zapier exibe o valor dele, antes de você conectar e ao lado do token depois.
- Notifuse Cloud: o campo já vem preenchido com a API do Cloud,
https://v3.notifuse.com. Deixe como está. - Self-hosted: cole o endereço que o painel exibe. É o endereço em que você abre o console do Notifuse, só o esquema e o domínio, sem nada depois do domínio e sem barra no final. Não apague o campo: uma URL da API vazia significa Notifuse Cloud, e não “esta instância”.
A sua instância precisa estar acessível pela internet pública, por HTTPS, com um certificado de uma autoridade certificadora pública. Let’s Encrypt serve.
Atenção
http:// simples, certificados autoassinados e autoridades certificadoras internas não são suportados, nem uma instância acessível só de dentro da sua rede. O Zapier exige HTTPS com um certificado publicamente confiável. Se a sua instância fica atrás de um firewall, saiba que o Zapier só publica um conjunto fixo de endereços IP de saída para liberar nos planos pagos.
Etapa 3: conecte o seu workspace
No Zapier, crie um Zap, procure Notifuse e escolha um gatilho ou uma ação. Quando o Zapier pedir para conectar uma conta, cole a chave API e, se você usa self-hosting, a sua URL da API.
Cada gatilho e cada ação do Notifuse pergunta então qual workspace usar, em uma lista suspensa.
Nota
Uma conexão com o Zapier cobre um único workspace. Uma chave API do Notifuse pertence a exatamente um workspace, então a lista suspensa só oferece esse e já o seleciona para você. Com vários workspaces, conecte o Zapier em Configurações → Integrações em cada um e adicione uma conexão separada no Zapier para cada. O Zapier identifica as conexões pelo nome do workspace e pelo host, então é fácil diferenciá-las.
Gerenciar a conexão depois
A conexão aparece como um card em Configurações → Integrações, com o seu rótulo, o endereço da chave que ela gerou e a data da conexão. Você pode renomeá-la ou excluí-la, com efeitos bem diferentes:
- Renomear muda só o rótulo no card. A chave mantém o endereço com que foi gerada, então o nome e o endereço podem ficar diferentes depois, e é por isso que o card mostra os dois. Nada precisa ser digitado de novo no Zapier.
- Excluir revoga a chave. Todos os Zaps que usam essa chave param de funcionar assim que você confirma. Uma chave revogada não pode ser restaurada, e reconectar gera uma nova, que você precisa colar no Zapier. Excluir o workspace revoga as chaves do Zapier da mesma forma.
As permissões de uma chave mudam em Configurações → Equipe e chaves API. Amplie ou restrinja a chave do Zapier ali: a alteração vale a partir da próxima requisição e o token não muda, então não há nada para digitar de novo no Zapier. Remover a linha da chave ali também a revoga, como excluir o card, mas deixa o card apontando para uma chave que não existe mais.
Gatilhos
| Gatilho | Dispara quando |
|---|---|
| New Contact | Um contato é adicionado ao workspace |
| Updated Contact | Os dados de um contato existente mudam |
| New List Subscriber | Um contato passa a ser inscrito ativo de uma lista |
| Contact Unsubscribed from List | Um contato cancela a inscrição em uma lista |
| Contact Joined Segment | Um contato passa a corresponder a um segmento |
| Contact Left Segment | Um contato deixa de corresponder a um segmento |
Os gatilhos de lista e de segmento permitem escolher uma lista ou um segmento específico. Escolha um: o Notifuse passa a enviar ao Zapier só os eventos dessa lista ou desse segmento, em vez dos de todas as listas do workspace, o que reduz o consumo de tarefas do seu Zap e a carga na sua instância.
New List Subscriber cobre três formas de entrada
Um contato pode passar a ser inscrito ativo de uma lista de três formas, e só a primeira é uma inscrição nova:
- Ele se inscreve pela primeira vez.
- Ele confirma uma inscrição com confirmação dupla que estava aguardando confirmação.
- Ele se inscreve de novo depois de ter cancelado a inscrição, ter tido um retorno ou ter denunciado spam.
New List Subscriber dispara nos três casos. Um contato que volta nunca gera um evento de primeira inscrição, então um Zap que observasse só esse evento perderia todos os inscritos que voltam, sem nenhum erro. Cada execução traz o evento específico, então você pode criar ramificações no Zapier para tratar de forma diferente quem se inscreve pela primeira vez e quem volta.
Updated Contact ignora salvamentos sem alteração
Updated Contact só dispara quando os dados de um contato mudam. Salvar um contato sem alterações, ou um job em segundo plano mexendo em um registro, não gera evento, então as atualizações internas de rotina não executam os seus Zaps.
O Zapier gerencia as próprias assinaturas de webhook
Ligar um Zap do Notifuse cria uma assinatura em Configurações → Webhooks, marcada como criada pelo Zapier. Desligar o Zap a remove.
Atenção
Não exclua manualmente uma assinatura de webhook criada pelo Zapier. O Zap dono dela para de receber eventos e não recria a assinatura sozinho: você precisa desligar e ligar o Zap de novo no Zapier, o que funciona mesmo com a assinatura já removida. Exclua o Zap e deixe que ele faça a limpeza.
Uma entrega que falha é repetida, então um Zap pode, de vez em quando, rodar duas vezes para o mesmo evento. Se o seu Zap faz algo que não pode acontecer duas vezes, como cobrar um cartão ou enviar uma mensagem, adicione um filtro do Zapier ou uma etapa de deduplicação.
Ações
| Ação | O que faz |
|---|---|
| Send Transactional Email | Envia uma das suas notificações transacionais a um contato, preenchendo as variáveis do template com dados do Zap |
| Create or Update Contact | Cria o contato se o endereço de email for novo e, caso contrário, o atualiza |
| Subscribe Contact to List | Cria ou atualiza o contato e o inscreve nas listas que você escolher, em uma única etapa |
As três ações identificam o contato pelo endereço de email, então executá-las de novo com o mesmo endereço atualiza o mesmo contato em vez de criar um duplicado.
Os campos personalizados de contato aparecem nessas ações com os rótulos que você deu a eles. Dê um nome a eles antes em Configurações → Campos personalizados: os campos sem rótulo ficam ocultos, então um campo que não aparece no Zapier geralmente ainda não tem rótulo.
Enviar é escolher, não redigir
Send Transactional Email não carrega o email em si. O template, o remetente, o rastreamento e o tratamento do cancelamento de inscrição ficam no Notifuse. O Zap escolhe qual notificação enviar, quem a recebe e os valores com que o template é renderizado.
Na etapa, escolha uma Notification na lista suspensa, mapeie um Email para o destinatário e preencha Template Data com uma linha para cada {{ variable }} que o seu template usa. Uma variável que você não fornece é renderizada vazia, sem erro. Se um email chegar com uma lacuna, comece conferindo a grafia dessa linha com a do template.
Dois detalhes sobre Template Data:
- Os valores chegam como texto. Exibir um valor funciona. Uma comparação como
{% if total > 100 %}não vai corresponder, porque compara com o texto"120", e não com o número. contactenotification_center_urlsão definidos pelo Notifuse e não podem ser substituídos pelo Zap. Linhas com esses nomes são ignoradas.
As notificações sem canal de email não aparecem na lista suspensa, já que enviar uma delas só poderia falhar.
Enviar também grava o contato
Um envio cria o contato se o endereço for novo, então você pode mandar um email a alguém no primeiro pedido sem uma etapa separada.
Qualquer campo de contato que você preencher sobrescreve o que está armazenado. Se você mapear First Name a partir de uma origem que às vezes vem em branco, essas execuções apagam o primeiro nome armazenado. Um campo deixado vazio no Zap mantém o valor armazenado; um campo mapeado prevalece. Para só enviar, preencha apenas o endereço de email.
Use Message External ID em tudo o que não pode ser enviado duas vezes
O Zapier repete uma etapa que falhou, e uma nova tentativa executa a ação inteira de novo. Uma notificação de envio de pedido duplicada é um pequeno incômodo; uma redefinição de senha ou uma confirmação de pedido duplicada é um problema de verdade.
Preencha Message External ID com um valor estável vindo do gatilho, como um número de pedido, o id de uma fatura ou o id do registro de origem. Um envio com um valor que o Notifuse já viu retorna a mensagem original em vez de enviar um segundo email. Em branco, toda execução envia.
A etapa não consegue dizer qual dos dois casos aconteceu: um envio deduplicado e um envio novo têm a mesma aparência no Zap History, ambos com sucesso e com o mesmo id de mensagem.
Atenção
Testar a etapa envia um email de verdade. O botão Test action do Zapier envia de verdade, como toda execução real, e não faz uma simulação. Use um endereço seu enquanto monta o Zap.
O status da inscrição nem sempre é ativo
Subscribe Contact to List retorna o status resultante para cada lista. Ele nem sempre é active, o que pode parecer um bug:
- Um contato que já cancelou a inscrição volta como
pending, e nãoactive, e recebe o email de confirmação da lista. O Notifuse impõe a confirmação dupla a qualquer pessoa que já tenha cancelado antes, independentemente da configuração da própria lista. Essa regra de conformidade não pode ser desativada. O Zap não falhou: o contato precisa confirmar antes de receber qualquer coisa. Uma lista sem template de confirmação dupla não tem email de confirmação para enviar, então esses contatos ficam empendingindefinidamente. Configure um antes de apontar um Zap de reengajamento para uma lista. - Um contato totalmente novo entra como
activemesmo em uma lista com confirmação dupla, e não recebe email de confirmação, porque a requisição veio de uma chave API autenticada, e não de um formulário de inscrição público.
Atenção
Antes de apontar um Zap de captação de leads para uma lista com confirmação dupla, saiba que os endereços novos pulam a etapa de confirmação. Só adicione pessoas a uma lista pelo Zapier com o consentimento delas, como faria ao importar um arquivo.
Em mais três casos a ação informa sucesso sem adicionar um novo inscrito. Eles não aparecem da mesma forma na saída, o que importa se você filtra pelo resultado:
- Um endereço que teve retorno ou denunciou spam não é inscrito de novo. Ele volta com o seu status final,
bouncedoucomplained, que uma etapa Filter baseada em Status enxerga. - Um contato que já está ativo na lista não é alterado. Executar o Zap de novo não muda nada, e a inscrição volta como
active. - Um endereço de um domínio de email descartável é descartado sem aviso. É o único caso sem nada a informar: a etapa tem sucesso sem nenhuma inscrição e com Status em branco. Nem a inscrição nem o contato são gravados.
Nota
Filtre pelo valor do status, e não pela existência de um status. Continue if Status exists deixa passar um endereço com retorno tanto quanto um ativo, já que os dois têm um status, e só barra o caso do domínio descartável. Para verificar que “o contato agora está inscrito”, teste se Status é active, ou se Memberships não está vazio quando você inscreve em várias listas ao mesmo tempo.
Solução de problemas
O teste de conexão falha
- Confira a URL da API: ela precisa começar com
https://e não ter caminho depois do domínio. O painel de conexão exibiu o valor exato, e reabrir o card só mostra o rótulo. Se você não tem mais esse valor, use o esquema e o domínio do endereço em que abre o console do Notifuse. - Abra
https://your-domain/api/workspaces.listem um navegador. Um erro de autenticação é a resposta esperada e prova que o endereço está acessível; um timeout, um erro de conexão ou um alerta de certificado significa que o Zapier também não consegue acessá-lo. - Confira se o certificado foi emitido por uma autoridade certificadora pública, e não é autoassinado nem interno.
- Se a chave foi revogada no Notifuse (excluindo a conexão com o Zapier ou removendo a linha dela em Configurações → Equipe e chaves API), a conexão para de funcionar na hora. O Zapier informa uma falha de autenticação e oferece reconectar a conta: conecte o Zapier de novo e cole o novo token.
Uma etapa falha com um erro de permissão
A mensagem indica a permissão que falta. Adicione-a à chave em Configurações → Equipe e chaves API; a alteração vale a partir da próxima requisição e o token continua o mesmo. Não conecte o Zapier de novo para resolver: uma nova conexão gera uma chave com as mesmas permissões padrão, e a etapa falha no mesmo ponto.
Se Send Transactional Email falha em Transacional, ou se o seletor de notificações dela está vazio e informa um erro de permissão, a conexão é anterior ao Notifuse 39.1, a versão que incluiu o envio nas permissões padrão. Marque leitura e escrita em Transacional na chave em Configurações → Equipe e chaves API, e a etapa funciona na próxima execução, sem reconectar nem trocar o token.
Um Zap parou de receber eventos
Abra Configurações → Webhooks no Notifuse e olhe a assinatura desse Zap:
- Desligada, com um motivo registrado. O Notifuse desativa uma assinatura automaticamente depois de uma longa sequência de entregas com falha e registra o motivo. Ligue-a de novo depois de corrigir a causa, ou simplesmente desligue e ligue o Zap no Zapier para recriá-la.
- Ausente. Alguém a excluiu manualmente, ou o Zap foi desligado. Desligue e ligue o Zap de novo.
O log de entregas de cada assinatura mostra cada evento enviado, a resposta do Zapier e o payload. É o jeito mais rápido de saber se o Notifuse chegou a enviar um evento.
O teste do gatilho não encontra dados
O Zapier procura atividade recente correspondente para montar o exemplo. Se uma lista não teve inscritos recentes, ou um segmento não teve novos membros, não há nada para mostrar. Crie um contato de teste, inscreva-o na lista e execute o teste de novo.
Limitações
- Uma conexão cobre um único workspace. Vários workspaces exigem várias conexões.
- A exclusão de contatos não dispara um Zap, nem os eventos de broadcasts ou de automações.
- Ainda não há etapa de busca: você não consegue procurar um contato no meio de um Zap sem uma ação que grave dados.
- Os campos personalizados precisam ter rótulo para aparecer em uma ação.
- Um envio não pode levar anexos. A API aceita anexos, mas o Zapier passa a uma etapa uma referência ao arquivo, e não o arquivo em si, então não há nada para anexar.
- Um envio não pode redigir um email. Ele envia uma notificação configurada no Notifuse e não pode fornecer o próprio corpo. Você pode substituir o assunto, o texto de pré-visualização, o nome do remetente e o endereço de resposta para uma mensagem.
Documentação relacionada
- Administradores e chaves API: o que cada permissão permite
- Webhooks: os tipos de evento e os payloads por trás dos gatilhos
- Contatos
- Listas
- Segmentos
