n8n: registar gravações, transcrições e resumos de chamadas

• Voys Intelligence e gravação de chamadas ambos ativados.
• Uma instância funcional de n8n.
• Conhecimento técnico
• Compreender como funcionam as notificações de chamada
• tê-las ativadas no freedom
• Compreensão básica de API's, mais particularmente a nossa API de obtenção de transcrição de chamadas e as api's dos sistemas à sua escolha!

Neste nó (webhook) vamos receber notificações de chamada ao enviar os dados do freedom para a nossa instância N8N. Para isso, precisa de adicionar o link do N8N nas notificações de chamada no Freedom. Desta forma, todas as notificações de chamada para todos os números e todas as chamadas (efectuadas + recebidas) serão enviadas para o N8N).

‣

N8N: copie o url do webhook aqui

‣

Freedom: cole o url do webhook aqui

A automatização descarrega a gravação diretamente da API Voys, e isso requer um token.

• Abra o fluxo de trabalho no n8n
• Clique no nó Download recording
• Authentication: Generic credential type
• Generic auth type: Bearer auth
• Bearer auth: create new
• Dê-lhe um nome e copie o seu token das configurações pessoais no freedom para o campo Bearer token

Abra o fluxo de trabalho no n8n e verá cinco caixas cinzentas. Aqui está cada nó nelas, por ordem.

1 Encaminhar por evento

• Listen to call notifications — o webhook. Captura todos os eventos de chamada que a Voys envia: a tocar, pendurar, gravação, transcrição, resumo.
• Switch — lê status e escolhe um caminho. ringing e in-progress param aqui propositadamente.

2 Gravação → Slack

• Download recording — obtém o WAV da API Voys. Tenta novamente algumas vezes, porque a gravação nem sempre está pronta no instante em que a chamada termina.
• Upload recording to Slack — coloca esse ficheiro de áudio diretamente no canal.

3 Transcrição → Claude

• Send to Claude — entrega o texto da transcrição ao Claude e pede as datas, nomes, números e itens de ação.

4 Lembrar quem ligou

• Extract customer number — descobre que lado da chamada é o cliente: o número que marcámos nas efectuadas, o número que nos ligou nas recebidas.
• Store call number — guarda esse número associado ao call_id, para que os outros caminhos o possam encontrar mais tarde.

5 Publicar e registar no HubSpot

• Build event — o ponto de encontro. Os três caminhos chegam aqui, e escreve uma mensagem Slack e uma nota, independentemente do evento que o desencadeou.
• optional: post call id and notify call recording is ready — publica essa mensagem no Slack.
• Look up call number — pega no call_id e encontra o número de telefone que o passo 4 guardou.
• Find HubSpot contact — procura no HubSpot um contacto com esse número.
• Get contact's company — segue esse contacto até à empresa a que pertence.
• Create HubSpot note — escreve a nota na linha temporal dessa empresa.