Configuração

Telefonia: click-to-call e gravação (Twilio Voice)

Ligue para contatos e leads com um clique e grave as chamadas usando a MESMA conta Twilio já configurada para SMS/WhatsApp (modelo BYO).

💡 Escolher o provedor de voz (Twilio ou GoTo): em Configurações → Telefonia, o card "Provedor de voz" permite escolher quem cuida do click-to-call e do SMS. O Twilio é o padrão de todos; o GoTo fica selecionável assim que você conecta sua conta GoTo em Configurações → Integrações. O softphone no navegador do GoTo chega em breve (hoje o Twilio faz o softphone no navegador); o GoTo funciona por click-to-call.

A Telefonia usa a MESMA conta Twilio que você já configurou para Mensagens (SMS/WhatsApp), no modelo BYO ("traga a sua própria conta"). As chamadas são feitas e cobradas na sua conta Twilio: não há custo, margem nem intermediação nossa. Você só precisa de um número Twilio habilitado para VOZ.

A funcionalidade é inerte: nada acontece até a integração Twilio estar configurada, ativada e com um número de voz preenchido.

Pré-requisitos

A integração Twilio (SMS/WhatsApp) já configurada e ativada, na mesma conta (Account SID + Auth Token).
Um número Twilio habilitado para VOZ, em E.164, para usar como caller ID.
Um telefone do agente para receber a perna da chamada (cada usuário pode informar o próprio na hora de ligar).
No Sellio, ser administrador para preencher o número de voz no cartão da Twilio.

Como funciona o click-to-call (bridge)

Não usamos telefone no navegador (WebRTC). O fluxo é 100% pelo servidor: quando você clica em "Ligar", o Twilio liga PRIMEIRO para o SEU telefone (o número do agente). Quando você atende, o Twilio conecta (faz o bridge) a chamada ao número do CONTATO e começa a gravar. Ao terminar, a duração e o link da gravação são registrados automaticamente.

O que você precisa configurar

A integração Twilio já configurada (Account SID + Auth Token), a mesma das Mensagens.
Número de voz (caller ID): um número Twilio habilitado para VOZ, em E.164 (ex.: +15005550006). É o identificador que aparece na chamada.
Telefone do agente (opcional): um número padrão que toca primeiro. Cada usuário também pode informar o próprio telefone na hora de ligar (fica memorizado no navegador dele).

Como configurar

Abra Configurações → Integrações e localize o cartão "Mensagens SMS/WhatsApp (Twilio)".
Preencha o "Número de voz (caller ID)" e, se quiser, o "Telefone do agente (padrão)". Reinforme o Auth Token e clique em "Salvar credenciais".
As URLs de TwiML e de status/gravação são apontadas automaticamente pelo próprio click-to-call: você NÃO precisa configurá-las no Console da Twilio.
Certifique-se de que a integração Twilio está "Ativada".

Como fazer uma ligação

Abra um Contato ou Lead que tenha telefone (campo Telefone ou Celular).
No quadro "Telefonia (chamadas)", clique em "Ligar".
Confira o número do contato, informe o SEU telefone (agente), se ainda não estiver memorizado, e clique em "Ligar agora".
Atenda quando o seu telefone tocar: o Twilio conecta você ao contato e grava a chamada.
A chamada aparece no histórico com status e, ao concluir, a duração e o link "Ouvir gravação". A atividade também entra na linha do tempo do registro.

💡 Se você tentar ligar sem a Twilio configurada (ou sem um número de voz), o CRM avisa de forma clara e nada é feito: a funcionalidade fica inerte até tudo estar no lugar.

O CRM verifica a assinatura X-Twilio-Signature dos webhooks de status e gravação usando o seu Auth Token. A gravação fica hospedada na sua conta Twilio; o link abre o áudio (.mp3). Trate o Auth Token como secreto: ele fica cifrado e nunca é exibido de volta.

Como testar

Abra um Contato/Lead com telefone e, no quadro "Telefonia (chamadas)", clique em "Ligar".
Informe o SEU telefone (agente) e clique em "Ligar agora".
Atenda quando o seu telefone tocar: o Twilio conecta você ao contato e começa a gravar.
Ao encerrar, confirme que a chamada aparece no histórico com a duração e o link "Ouvir gravação".

Solução de problemas

O botão "Ligar" avisa que falta configuração: a Twilio não está ativada ou o "Número de voz (caller ID)" não foi preenchido. Complete-os no cartão da Twilio.
401 / a chamada não inicia: Account SID/Auth Token errados. Reinforme o Auth Token ao salvar o número de voz.
O meu telefone não toca: verifique o número do agente em E.164 e se o número de voz Twilio pode originar chamadas para o seu país (Geo Permissions no Console da Twilio).
Sem gravação ou sem duração ao final: os webhooks de status/gravação são apontados automaticamente pelo click-to-call: se falharem, confira que o Auth Token está correto (a assinatura X-Twilio-Signature é verificada com ele).
Não preciso configurar URLs na Twilio: correto, as URLs de TwiML e de status/gravação são definidas pelo próprio fluxo; não configure webhook manual no número para voz.

Abrir este artigo dentro do sistema →