Este tutorial mostra como integrar o NTFONE ao seu CRM, registrando automaticamente toda chamada recebida ou realizada através da plataforma.
Por que usar essa integração
A maioria das empresas precisa manter um histórico das conversas telefônicas trocadas com cada cliente dentro do CRM — sem isso, informações como horário da ligação, quem atendeu, quem ligou e duração ficam perdidas.
Com essa integração, cada chamada que passa pelo NTFONE gera automaticamente uma nota no perfil correspondente do cliente no CRM, contendo:
- Horário exato da chamada
- Ramal ou colaborador que atendeu
- Duração da conversa
- Identificação do cliente (via Caller ID)
Como configurar
A integração depende de duas APIs: a API Phone Call Events do NTFONE e a API do seu CRM.
No exemplo a seguir, vamos registrar todas as chamadas recebidas na linha de suporte ao cliente — um ramal vinculado a um DID externo.
O caminho é simples:
- Crie um script (qualquer linguagem serve) que receba os parâmetros da chamada do NTFONE e grave a anotação no CRM.
- Hospede o script em uma URL acessível, por exemplo
https://seu-dominio.com/LogIncomingCalls.php. - Na interface do NTFONE, configure os Phone Call Events do ramal para acionar esse script no evento Dial-In. Detalhes em Phone Call Events.
Se você tem vários ramais, repita o passo 3 para cada um.
Como funciona na prática
Quando o NTFONE recebe uma chamada na linha de suporte, seu script é chamado com uma série de parâmetros (lista completa aqui). Uma estrutura básica em PHP seria:
if (isset($_GET['CallerIDNum']) && isset($_GET['CalledExtension'])) {
// identifica o cliente no CRM pelo Caller ID
$CRMcustomerID = identifyCustomer($_GET['CallerIDNum']);
// identifica o colaborador que atendeu pelo ramal
$employeeName = identifyEmployee($_GET['CalledExtension']);
// cria a nota no perfil do cliente
leaveNote(
$CRMcustomerID,
"Chamada recebida em " . date('Y-m-d H:i:s')
. " atendida por " . $employeeName
. " (" . $_GET['CalledExtension'] . ")"
);
}Quando o script roda, uma nota como "Chamada recebida em 2026-04-21 14:51:23 atendida por Maria Silva (003*021)" é publicada no perfil do cliente que ligou.
Dica: o exemplo Track My Calls da documentação 4PSA serve como ponto de partida. Basta substituir as chamadas de banco de dados do exemplo pelas chamadas da API do seu CRM.
Dicas e refinamentos
Use a API GetExtensionDetails para buscar informações adicionais sobre o ramal que atendeu a chamada — útil para enriquecer o log com dados do colaborador.
Para registrar a duração da chamada, combine os eventos Dial-In e Hangup: o primeiro cria a nota no início da chamada, o segundo a atualiza no final com o tempo total.
Se precisar de um exemplo completo para um CRM específico (HubSpot, Pipedrive, RD Station, Zoho, etc.), abra um ticket no Painel da NTWeb descrevendo seu cenário e podemos orientar a implementação.