Use o ThunderPhone com o Zapier

Conecte o aplicativo ThunderPhone no Zapier à sua organização e crie um Zap que é executado sempre que uma chamada termina.

Zapier 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. Para uma visão geral das duas formas de usar o Zapier com o ThunderPhone, consulte a página de integração do 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.

1. 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.

2. 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.

3. 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.

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.

1. 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.

2. 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.

3. 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).

4. 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.

5. Teste

   Faça outra chamada de teste no construtor. Quando ela terminar, o Zap será executado e uma linha aparecerá.

Colunas úteis:

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 para ver todos os campos.

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.

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:

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.

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.
• 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.

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 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.

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.

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 mostra tentativas recentes de entrega.