Pular para o conteúdo

Integre as chamadas NTFONE no seu CRM

ntfone, ntfone-cc Útil: 0

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:

  1. Crie um script (qualquer linguagem serve) que receba os parâmetros da chamada do NTFONE e grave a anotação no CRM.
  2. Hospede o script em uma URL acessível, por exemplo https://seu-dominio.com/LogIncomingCalls.php.
  3. 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.

Esta resposta lhe foi útil?

Artigos Relacionados

« Retornar