---
title: "Use o ThunderPhone com o Zapier"
description: "Conecte o aplicativo ThunderPhone no Zapier à sua organização e crie um Zap que é executado sempre que uma chamada termina."
---

[Zapier](https://zapier.com) conecta aplicativos com fluxos de trabalho automatizados chamados
Zaps. O aplicativo ThunderPhone no Zapier adiciona:

- **Gatilhos:** **Chamada concluída** é acionado quando uma chamada telefônica, pela web ou de teste termina.
  **Chamada avaliada** é acionado quando a avaliação de uma chamada concluída fica disponível.
- **Ações:** **Fazer chamada de saída**, **Adicionar contatos à campanha** e
  **Iniciar campanha**.
- **Pesquisa:** **Encontrar chamada** procura uma chamada por ID e a retorna com sua
  transcrição e uma URL assinada da gravação, quando disponível.

Encontre-o em [ThunderPhone no Zapier](https://zapier.com/apps/thunderphone/integrations).
Para uma visão geral das duas formas de usar o Zapier com o ThunderPhone, consulte a
[página de integração do Zapier](https://thunderphone.com/integrations/zapier).

## Conecte sua organização

O aplicativo se conecta por OAuth. Você entra no ThunderPhone e aprova
o acesso a uma organização, sem copiar nenhuma chave de API para o Zapier.

<Steps>
  <Step title="Adicione uma etapa do ThunderPhone">
    No editor do Zap, pesquise por **ThunderPhone** (exibido com o rótulo Beta)
    e escolha um gatilho ou uma ação. Quando o Zapier solicitar uma conta, conecte uma nova. O Zapier abre
    uma janela de login do ThunderPhone.
  </Step>
  <Step title="Entre e escolha a organização">
    Entre, confira as permissões solicitadas, escolha a organização e
    selecione **Aprovar**. O aplicativo solicita permissão para ler seus agentes e números de telefone,
    ler e gravar chamadas e campanhas, gerenciar integrações, como endpoints de webhook,
    e ver o e-mail da sua conta.
  </Step>
  <Step title="Confira o nome da conexão">
    O Zapier nomeia a conexão com base na organização que você aprovou, para que
    você possa distinguir as conexões quando pertencer a mais de uma.
  </Step>
</Steps>

Conecte-se com uma conta que tenha a função de administrador ou proprietário nessa
organização. Ativar ou desativar um Zap de gatilho, assim como todas as ações, exige essa
função. Um Zap de gatilho que já está ativo continua recebendo eventos de chamadas após a
mudança de função ou a revogação da conexão. Desative-o para interrompê-los. Encontrar
chamada funciona para qualquer membro.

O aplicativo não tem cobrança própria do ThunderPhone. As chamadas que ele faz ou inicia
são cobradas conforme as tarifas normais do ThunderPhone, e o Zapier contabiliza tarefas no seu
plano do Zapier.

## Crie seu primeiro Zap

Este Zap adiciona uma linha a uma planilha do Google Sheets sempre que uma chamada termina.

<Steps>
  <Step title="Faça uma chamada para usar como dados de exemplo">
    Abra um agente no construtor, clique em **Falar** e encerre a chamada. As
    chamadas de teste do construtor acionam Chamada concluída, então isso fornece
    ao gatilho uma chamada recente para carregar.
  </Step>
  <Step title="Adicione o gatilho">
    Escolha **ThunderPhone** como o app de gatilho, defina o evento como
    **Chamada concluída** e selecione sua conexão do ThunderPhone. Teste o
    gatilho. O Zapier carrega suas chamadas concluídas mais recentes como
    exemplos, no mesmo formato de um evento em tempo real.
  </Step>
  <Step title="Adicione o Google Sheets">
    Adicione uma ação do Google Sheets que crie uma linha na planilha. Escolha
    uma planilha com uma linha de cabeçalho e mapeie cada coluna para um campo
    do gatilho (consulte a tabela abaixo).
  </Step>
  <Step title="Publique o Zap">
    Publique e ative o Zap. Ativá-lo cria um endpoint de webhook na sua
    organização do ThunderPhone chamado **Zapier: Chamada concluída**.
    Desativar o Zap exclui esse endpoint.
  </Step>
  <Step title="Teste">
    Faça outra chamada de teste no construtor. Quando ela terminar, o Zap será
    executado e uma linha aparecerá.
  </Step>
</Steps>

Colunas úteis:

| Coluna | Campo de Chamada concluída |
|---|---|
| ID da chamada | ID da chamada |
| Agente | Nome do agente |
| Direção | Direção |
| De | Número de origem |
| Para | Número de destino |
| Início | Iniciado em |
| Término | Encerrado em |
| Duração (s) | Duração em segundos |
| Status | Status |
| Motivo do término | Motivo do término |
| Link da chamada | Digite `https://app.thunderphone.com/dashboard/call-history/` e insira o ID da chamada |

O link da chamada abre a chamada no painel do ThunderPhone para membros da
sua organização, com a transcrição e a gravação, para que a planilha não
precise armazenar nenhuma delas.

O evento também pode incluir a transcrição, como uma lista de turnos, e uma
URL da gravação, um link assinado que expira. Adicione-os somente se a
planilha precisar deles. Transcrições, resumos e gravações de chamadas podem
conter informações pessoais ou de saúde. Envie-os somente para apps que sua
organização tem permissão para usar com esses dados, sob um BAA quando houver
informações de saúde envolvidas, e mantenha apenas os campos necessários.
Consulte [`telephony.complete` / `web.complete`](/pt/webhooks/call-complete) para
ver todos os campos.

<Note>
  Todas as entregas são assinadas. O app verifica o HMAC
  `X-ThunderPhone-Signature` em relação ao segredo do endpoint antes da
  execução do Zap e interrompe qualquer entrega não assinada ou inválida. Se o
  Zapier não aceitar uma entrega, o ThunderPhone tentará novamente por até 24
  horas. Consulte a [visão geral de webhooks](/pt/webhooks/overview).
</Note>

## Gatilhos, ações e pesquisa

**Chamada avaliada** fornece o ID da chamada, o ID do agente, o nome do agente e a avaliação: ID da avaliação, pontuação, resultado da chamada, resumo, modelo de avaliação e data da avaliação. Ativar um Zap cria um endpoint chamado **Zapier: Chamada avaliada**. Uma chamada pode ser avaliada mais de uma vez, e cada execução de avaliação concluída aciona o gatilho. Consulte
[`call.graded`](/pt/webhooks/events).

**Encontrar chamada** recebe um ID de chamada, com uma lista suspensa de chamadas recentes. Retorna o agente da chamada, a direção, os números, os horários de início e término, o status, o motivo de término, a pontuação da avaliação e o resultado da chamada, a transcrição e uma URL de gravação assinada quando disponível. Um ID de chamada desconhecido não retorna resultados em vez de um erro.

**Fazer chamada de saída** recebe:

| Campo | Significado |
|---|---|
| Agente | Um agente salvo. A lista suspensa mostra seus agentes. |
| Número de destino | Destino no formato E.164, como `+14155552671`. |
| Número de origem | A lista suspensa mostra apenas números habilitados para chamadas de saída. |
| Variáveis | Objeto JSON opcional de valores para placeholders no prompt do agente. |
| Chave de idempotência | Um ID estável do gatilho ou registro de origem. Obrigatório. |

Retorna o ID da chamada, o status e a repetição idempotente.

**Adicionar contatos à campanha** adiciona contatos a uma campanha em rascunho. Para um contato, preencha **Número de telefone** no formato E.164 e, opcionalmente, **Variáveis de contato**, um objeto JSON cujas propriedades se tornam variáveis da campanha. Para um lote, preencha **JSON de contatos** com uma matriz de até 5.000 objetos. Cada objeto precisa de `phone_number`, e suas outras propriedades se tornam variáveis. A etapa falha quando todos os contatos são rejeitados e define **Sucesso parcial** quando apenas alguns são aceitos.

**Iniciar campanha** inicia ou retoma uma campanha que tenha pelo menos um contato. Requer **Consentimento para cobrança**. Consulte
[Campanhas de saída](/pt/guides/outbound-campaigns).

## Antes de um Zap fazer chamadas

Fazer chamada de saída e Iniciar campanha discam números de telefone reais e iniciam chamadas faturáveis.

- Se o ThunderPhone solicitar que sua organização confirme que as chamadas de saída seguem a TCPA e outras leis de chamadas, um administrador deverá registrar essa confirmação no painel antes que um Zap possa iniciar chamadas.
- O Número de origem deve estar habilitado para chamadas de saída. Números trazidos da sua própria operadora se qualificam após a verificação. Números fornecidos pelo ThunderPhone começam apenas para chamadas recebidas, e você pode solicitar acesso a chamadas de saída para eles no painel. Consulte [Obter um número de telefone](/pt/guides/get-a-phone-number).
- Fazer chamada de saída requer uma **Chave de idempotência**. Mapeie um ID estável do gatilho ou registro de origem, como o ID do evento do ThunderPhone ou o ID de um registro de CRM. Se o Zapier repetir a etapa, o ThunderPhone reconhecerá a chave e retornará a chamada original em vez de fazer uma segunda chamada. Evite carimbos de data e hora, valores aleatórios ou apenas o ID do Zap.
- Iniciar campanha requer **Consentimento para cobrança**, que confirma que o Zap pode iniciar chamadas de saída faturáveis na sua conta.
- Sua organização é responsável por ter consentimento para ligar para cada número e por seguir as leis de chamadas aplicáveis. Consulte
  [leis de chamadas de saída](/pt/guides/outbound-calling-laws).

Uma chave de idempotência é exclusiva em toda a sua organização e pode ter no máximo 128 caracteres. Reutilizar uma chave com um agente, número ou variáveis diferentes falha por conflito; portanto, se dois Zaps puderem ligar sobre o mesmo registro, atribua a cada Zap seu próprio prefixo fixo antes do ID do registro.
[Fazer chamadas de saída](/pt/guides/place-outbound-calls) aborda a API por trás desta ação.

## Exemplos de Zaps

- **Chamada concluída para um CRM.** Registre uma atividade para cada chamada concluída com seu status, motivo de encerramento e transcrição.
- **Chamada avaliada para acompanhamento.** Filtre pelo resultado ou pela pontuação da chamada e direcione a chamada para o fluxo de acompanhamento correto.
- **Novo lead para uma campanha.** Adicione o lead a uma campanha em rascunho com Adicionar contatos à campanha e, em seguida, execute Iniciar campanha depois que alguém aprovar a lista.

As transcrições, os resumos e as gravações de chamadas podem conter informações pessoais ou de saúde. Envie-os apenas para aplicativos que sua organização está autorizada a usar para esses dados, sob um BAA quando houver informações de saúde envolvidas, e mantenha apenas os campos necessários.

## Solução de problemas

**Uma etapa falha com um erro de autorização.** Reconecte a conexão do ThunderPhone no Zapier e aprove novamente. Uma conexão deixa de funcionar quando a pessoa que a conectou a revoga no ThunderPhone em **Organização → Chaves → Aplicativos autorizados**, quando essa pessoa sai da organização ou quando passam 30 dias sem uma atualização bem-sucedida do token. Consulte [Conectar com OAuth](/pt/guides/oauth).

**Ativar ou desativar um Zap falha, ou uma ação é recusada.** A pessoa que se conectou precisa ter a função de administrador ou proprietário na organização. Reconecte com uma conta que tenha essa função. Um Zap de gatilho que já está ativado continua recebendo eventos de chamada após a alteração da função ou a revogação da conexão. Desative-o para interrompê-los.

**Você quer desconectar o aplicativo.** Desative seus Zaps do ThunderPhone antes de revogar a conexão, pois desativar um Zap exclui seu endpoint e requer uma conexão funcional. Se você revogou primeiro, exclua o endpoint restante **Zapier: …** com `DELETE /v1/developer/webhook-endpoints/{id}` usando uma chave de API de administrador. Consulte [Endpoints de webhook](/pt/webhooks/endpoints).

**O Zap deve usar outra organização.** Cada conexão abrange uma organização. Desative primeiro o Zap para que seu endpoint de webhook seja excluído da organização atual. Em seguida, conecte uma nova conta do ThunderPhone no Zapier, escolha a outra organização ao aprovar e selecione essa conexão em cada etapa do ThunderPhone. Agentes, números e campanhas são diferentes entre organizações, então selecione novamente **Agente**, **Número de origem** e **Campanha** em cada etapa que os tiver. Depois, ative o Zap novamente.

**O gatilho parou de disparar.** Cada Zap com um gatilho do ThunderPhone possui um endpoint de webhook na sua organização, chamado **Zapier: Chamada concluída** ou **Zapier: Chamada avaliada**. Ele é criado quando o Zap é ativado e excluído quando é desativado. Deixe-o como está. Se ele foi editado ou excluído no ThunderPhone, desative e ative o Zap novamente para criar um novo.
Com uma chave de API de administrador,
[`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries)
mostra tentativas recentes de entrega.

<Note>
  Quer que o agente use ações do Zapier durante uma chamada em vez de depois dela?
  Conecte um endpoint MCP do Zapier em **Conexões → MCP**. Consulte
  [Servidores MCP](/pt/guides/mcp-servers). Para enviar os mesmos eventos de chamada ao seu
  próprio servidor, consulte [Endpoints de webhook](/pt/webhooks/endpoints).
</Note>