Um envio de formulário pode disparar um e-mail de confirmação sem precisar de um serviço customizado. O workflow ainda precisa tratar uma rejeição que chega depois que o passo de envio termina.
Como conecto o Bird ao n8n?
Instale o node verificado do Bird pelo painel de nodes no n8n Cloud ou em uma instância auto-hospedada com nodes comunitários verificados habilitados.
- Crie um novo workflow.
- Abra o painel de nodes selecionando + ou pressionando Tab.
- Pesquise por Bird.
- Selecione Install para instalar o node na sua instância.
- O node Bird agora está disponível nos seus workflows.
Para n8n auto-hospedado, atenda aos requisitos de runtime antes de instalar. Se os nodes comunitários não estiverem disponíveis no painel, acesse Settings > Community Nodes > Install. Insira @messagebird/n8n-nodes-bird como nome do pacote.
Crie a chave em API keys no dashboard do Bird. Adicione uma credencial Bird API no n8n contendo essa chave API do espaço de trabalho.
Conceda os escopos listados pela credencial para as operações selecionadas, para que o workflow possa fazer essas requisições.
Selecione um recurso e uma operação no node Bird. Ele suporta e-mail, SMS, WhatsApp e verificação, além de operações de configuração e relatórios.
O node exclui publicação e assinaturas do Realtime porque sua credencial não comporta a app key e o secret necessários.
Downloads de bytes e buscas de mídia baseadas em redirecionamento também são excluídos. O node espera resultados JSON para itens do workflow. Use um client apropriado ou uma requisição HTTP para essas operações.
Como conecto o Bird ao Zapier?
Selecione Bird no Zapier. Clique em Connect. Autorize a conexão no Bird.
O Zapier armazena a conexão do OAuth, então você não precisa colar uma chave API. A conexão pertence ao espaço de trabalho e se mantém mesmo que a pessoa que autorizou mude de equipe.
Gerencie o acesso na página Integrations do espaço de trabalho. Revogar a conexão interrompe os Zaps que a utilizam.
Escolha Send Email, Send SMS ou Send WhatsApp Message para um passo de envio. Start Verification e Check Verification Code tratam a verificação por código de verificação.
Os passos de busca recuperam mensagens e seus eventos. A integração com o Zapier descreve as ações e buscas disponíveis.
Como inicio um workflow a partir de um evento de entrega?
Use Bird Trigger no n8n ou New Event no Zapier. Selecione os eventos que seu workflow precisa.
A integração registra um endpoint de webhook para o workflow. Ela verifica as assinaturas de entrega antes de passar os eventos para sua automação.
Cada workflow acionado por evento precisa do seu próprio endpoint. A cota de endpoints do Bird começa em um por organização, então um webhook existente pode impedir a criação de outro gatilho.
Solicite ao suporte o aumento da cota antes de adicionar mais workflows acionados por evento. Ações de envio e buscas não precisam cada uma de seu próprio endpoint de webhook.
O que um passo de envio bem-sucedido prova?
Ele prova que o Bird aceitou a solicitação de envio. Não confirma o resultado posterior da entrega.
Armazene o ID da mensagem retornado. Use eventos de entrega e falha para atualizar o registro que disparou o envio.
Uma mensagem de formato livre do WhatsApp pode falhar se a janela de atendimento ao cliente fechar antes do despacho. Essa falha posterior chega depois que o passo de envio é bem-sucedido. Use um template aprovado ao enviar mensagens fora da janela de atendimento ao cliente.
O node Bird do n8n envia um Idempotency-Key estável para cada operação, então uma nova tentativa do workflow não envia duas vezes. O Zapier não envia chave de idempotência, então uma repetição da plataforma pode duplicar um envio.
Quando devo usar low-code ou escrever um serviço?
Use low-code quando o envio faz parte de um processo já gerenciado pela sua ferramenta de workflow. Use um serviço quando você precisa controlar o estado durável de novas tentativas e entregas.
Um lote de e-mail ou SMS no n8n pode enfileirar até 100 mensagens em uma chamada. Um job de 250 mensagens leva três chamadas quando agrupado, em vez de 250 requisições individuais.
Para uma ferramenta sem integração com o Bird, use o bloco HTTP dela. Importe a especificação OpenAPI do Bird se a ferramenta suportar geração de client a partir dela.
- n8n: configure o node Bird com uma chave API do espaço de trabalho.
- Zapier: autorize o app Bird. Selecione suas ações ou gatilho de evento.
- Bloco HTTP: forneça os detalhes da requisição quando não existir integração Bird.
- Serviço customizado: controle você mesmo o estado de entrega armazenado e a política de novas tentativas.
Em resumo
Conecte com a credencial que sua ferramenta espera.
O n8n usa uma chave API do Bird. O Zapier pede que você autorize uma conexão pertencente ao espaço de trabalho pelo Bird.
Reserve um endpoint de webhook para cada gatilho.
Cada workflow ou Zap que usa um gatilho de evento do Bird precisa do seu próprio endpoint dentro da cota da sua organização.
Verifique o evento de entrega.
Um passo de envio bem-sucedido confirma a aceitação. A entrega ou falha chega depois, então guarde o ID da mensagem para reconciliação.
Mantenha o estado de nova tentativa para a operação de negócio.
O n8n envia uma chave de idempotência estável para novas tentativas. O Zapier não envia nenhuma, então uma repetição pode duplicar um envio.