Conecte o Zapier ou o n8n

O Zapier e o n8n são ferramentas de automação. Eles conseguem passar dados de quase qualquer outro app para o BytePhase. Por exemplo, uma nova linha numa planilha pode virar um lead.

Antes de começar

• Você precisa de uma conta no Zapier ou no n8n. No Zapier, a etapa Webhooks by Zapier é um recurso pago do Zapier.
• Você pode conectar em qualquer plano. Para ver as consultas, você precisa do plano Standard ou superior.
• Ajuda ter alguém que já montou um Zap ou um fluxo no n8n.

Passo a passo

1. Vá em Settings › Integrations. Em Website & forms, clique em Connect no Zapier ou no n8n.

2. Escolha Self check-in ou Lead e clique em Next.

3. Copie a API key e a Endpoint URL. No Zapier, aparece também uma API base URL.

   A API key só aparece uma vez. Copie agora.

   

   Computador

4. Monte a conexão na sua ferramenta. How to connect na tela lista os passos:

   • Zapier: no seu Zap, adicione uma ação Webhooks by Zapier › POST. Cole a Endpoint URL e adicione a sua API key como explicado na tela. Ou, no Zapier, pesquise “BytePhase” e conecte com a API key e a API base URL.
   • n8n: adicione um nó HTTP Request, clique em Import cURL e cole o exemplo curl de Code examples.

   As seções abaixo mostram o que escolher dentro do Zapier e do n8n.

5. Rode um teste na sua ferramenta: a etapa Test do Zapier, ou execute o nó no n8n. Depois clique em Check now no BytePhase.

   Aparece Test submission captured.

6. Clique em Next em Match fields e em If customer exists, depois clique em Activate integration.

Pronto!

O seu Zap ou fluxo do n8n agora cria leads ou autoatendimentos no BytePhase toda vez que roda.

Montar o Zap no Zapier

1. No Zapier, clique em Create e depois em Zap.

2. Escolha como gatilho o app de onde vêm os seus dados. No Google Forms, escolha New Form Response, e não New or Updated Form Response. Senão, uma resposta editada gera um segundo lead.

3. Clique em Test trigger para o Zapier encontrar uma entrada recente. Se não encontrar nada, preencha o seu formulário uma vez e teste de novo.

4. Adicione uma ação: Webhooks by Zapier e depois POST. Preencha assim:

   • URL: a Endpoint URL do BytePhase.
   • Payload Type: Json. Wrap Request In Array: No. Unflatten: Yes.
   • Headers: adicione X-API-Key com a sua API key. Adicione também Content-Type e Accept, os dois com application/json.
   • Data: copie o formato do exemplo curl de Code examples. Os seus campos vão dentro de data. Preencha cada valor com o seletor do Zapier em vez de digitar.

5. Se quiser, adicione uma etapa Filter by Zapier antes da ação. Deixe passar só as entradas que têm um nome e um e-mail ou celular. Isso segura o spam.

6. Depois de ativar a integração no BytePhase, clique em Publish no Zapier.

Montar o fluxo no n8n

O Import cURL preenche o nó HTTP Request para você. Para preencher à mão:

1. Coloque Method em POST e URL com a Endpoint URL do BytePhase.

2. Adicione dois cabeçalhos: X-API-Key com a sua API key e Content-Type com application/json.

3. Envie o corpo como JSON, no mesmo formato do exemplo curl. Os seus campos vão dentro de data.

4. Se os nomes dos seus campos forem diferentes dos do BytePhase, adicione um nó Set antes. Renomeie os campos para os nomes de View available fields.

Salve a sua API key nas credenciais do n8n em vez de digitá-la no nó. Assim ela não aparece se você exportar o fluxo.

O que o app do BytePhase no Zapier faz

Quando você conecta pelo app do BytePhase no Zapier, uma conexão oferece:

• Gatilhos (algo acontece no BytePhase): nova ordem de serviço, cliente, lead, pagamento, ordem de serviço terceirizada ou mudança de status de uma ordem de serviço.
• Ações (o BytePhase faz algo): criar um cliente, criar um lead ou adicionar um autoatendimento.
• Busca: encontrar um cliente.

Bom saber

• Para ver cada envio e se deu certo, use View activity no cartão.
• Para a lista completa de campos que o BytePhase aceita, clique em View available fields na etapa de conexão, ou veja developers.bytephase.com.
• Se a sua API key vazar, use Rotate key na página de atividade. Depois atualize o seu Zap ou fluxo com a nova chave.
• Se o Zapier repetir uma etapa, o BytePhase pode criar um segundo registro. A sua escolha em If customer exists é o que evita repetições. No n8n, adicione um cabeçalho Idempotency-Key com um valor único para cada entrada, assim uma repetição é ignorada.