Saltar para o conteúdo
REST API

Resultados de chamadas no Google Sheets

Importe o modelo do n8n e escreva uma chamada de exemplo no Google Sheets. Ligue a sua conta Volai para registar automaticamente as próximas chamadas concluídas.

1Importe o fluxo para o n8n

Guarde o ficheiro JSON a partir da ligação acima. No editor do n8n, abra o menu do fluxo e selecione Import from File. O modelo usa nós integrados e foi testado com o n8n 2.48.5.

2Prepare a folha de cálculo

Crie um separador vazio no Google Sheets com o nome Call results. Copie o cabeçalho abaixo e cole-o em A1. Coloque cada valor numa coluna da primeira linha.

text
Call ID	Event time (UTC)	Direction	Status	Duration (s)	Mode

3Escreva uma linha de exemplo

Em Write call result to Google Sheets, selecione as credenciais OAuth2 do Google Sheets. Em Document, selecione By ID e cole a parte do URL entre /d/ e /edit. Mantenha Call results no campo Sheet. Para experimentar sem uma conta Volai, desative Confirm successful write. Execute o fluxo a partir de Test with a sample call. Procure DEMO-call-result-001 com sample na coluna Mode. Uma nova execução atualiza a mesma linha.

4Ligue a sua conta Volai

Crie uma conta Volai e gere uma chave nas definições da API. No n8n, crie uma credencial Header Auth. Introduza Authorization no campo Name e Bearer <API key> em Value, substituindo <API key> pela sua chave. Escolha o nome de apresentação que preferir. Selecione-a em Read Volai call event e, para enviar a confirmação opcional, também em Confirm successful write. Nesse caso, ative o nó e execute o exemplo novamente.

5Subscreva as chamadas concluídas

Em Volai call completed, copie o endereço público HTTPS em Production URL. Se o caminho do webhook já estiver em uso, altere-o antes de o copiar. Substitua o endereço de exemplo no comando abaixo e execute-o em Bash ou Zsh. Quando lhe for pedida a chave API, introduza-a. Mantenha a resposta privada e copie dela o valor de deliveryToken.

bash
(
  printf 'Volai API key> '
  IFS= read -rs VOLAI_API_KEY
  printf '\n'
  printf 'Authorization: Bearer %s\n' "$VOLAI_API_KEY" |
    curl --fail-with-body --silent --show-error \
      --header @- \
      --header 'Content-Type: application/json' \
      --data '{"url":"https://your-n8n.example/webhook/volai-call-result-to-sheets","events":["call.completed"]}' \
      https://volai.cz/v1/webhook-subscriptions
)

6Publique o fluxo de trabalho

Crie uma segunda credencial Header Auth. Introduza X-Volai-Webhook-Token em Name e o valor de deliveryToken da resposta da API em Value. Selecione-a em Volai call completed e publique o fluxo. Após a próxima chamada concluída, procure uma linha com live. Antes de escrever, o fluxo valida o token e lê o evento da Volai.

O que pode fazer com isto

Relatório diário de chamadas

Conte as chamadas concluídas por dia utilizando a hora do evento em UTC.

Carga de trabalho da equipa

Compare o número e a duração das chamadas recebidas e efetuadas numa tabela dinâmica.

Verificação da automatização

Associe as linhas ao histórico da Volai através do identificador da chamada.

Perguntas frequentes

O que é escrito na folha?
Cada linha tem o identificador da chamada, a hora do evento em UTC, o sentido, o estado, a duração em segundos e o modo sample ou live. Os números de telefone, as transcrições e as gravações ficam de fora.
O que é medido pelo fluxo?
Após uma escrita bem-sucedida, Confirm successful write pode enviar uma confirmação à Volai. Para contas criadas a partir deste guia com consentimento para medição, a Volai conta separadamente a primeira execução de exemplo e a primeira execução real confirmadas nos sete dias após o registo. A confirmação não inclui células. Em execuções reais, a Volai confirma a titularidade e o estado através dos identificadores da subscrição e do evento. Desative o nó para desligar o envio.
A mesma chamada pode aparecer duas vezes?
Execuções consecutivas atualizam a linha com o mesmo Call ID. Use um fluxo por separador. O Google Sheets pode criar duas linhas para a mesma chamada quando há escritas em simultâneo.
O que devo verificar se faltar uma linha?
Verifique os erros do exemplo no próprio editor do n8n. Para uma chamada real, ative temporariamente Save failed production executions nas definições do fluxo, reproduza o problema e procure o passo em que ocorreu o erro no histórico. Depois desative a gravação das execuções. Se a escrita falhou, verifique as permissões do Google, o ID da folha de cálculo, o nome do separador e o cabeçalho exato. Para o webhook, confirme a publicação, o URL público e o token.

Experimente já

Registe-se e os primeiros 2 € são por nossa conta.