Pular para o conteúdo

Integrações

Entra no CRM que a operação já usa.

A barra entra na tela do CRM e fala com a plataforma só por API. No fim da ligação, o CRM recebe o desfecho e o link da gravação.

O ekovox nunca escreve no banco do CRM. A integração usa três meios: a barra, dentro da página do CRM; a API REST, que o backend do CRM chama; e o webhook (aviso automático de sistema para sistema), assinado em HMAC-SHA256, que a plataforma envia ao CRM.

Para quem

Para quem não vai trocar de CRM.

Para a operação de cobrança, vendas, SAC, retenção ou jurídico que já trabalha num CRM e quer telefonia, discador e IA na ligação sem mudar de sistema. E para a TI que não abre o banco do CRM a fornecedor: tudo passa por API, com o escopo definido na implantação.

O que a integração pede

  • Um CRM com página web, onde a barra entra como componente.
  • Um endereço do CRM que receba o webhook do fim da ligação.
  • Uma operadora SIP e os números da operação.

Como se integra

Quatro direções, nenhuma pelo banco do CRM.

Quem chama, o que leva e por qual meio: REST, eventos ao vivo ou webhook assinado.

As quatro direções da integração

ekovox

Barra e plataforma de voz. Nunca escreve no banco do CRM.

  • Na tela do operador

    A barra fala por REST, com a sessão do operador; os eventos da ligação chegam ao vivo.

  • Do CRM para a ligação

    O CRM envia à barra o contexto da ficha e o roteiro da campanha.

  • Do CRM para a plataforma

    O backend do CRM chama a API REST com a chave de API do cliente.

  • Da plataforma para o CRM

    No fim da ligação, o webhook assinado leva o desfecho e o link da gravação.

  • Tela

    Na tela do operador

    • A barra é um componente web (Web Component) dentro da página do CRM.
    • Fala com a plataforma por REST, com a sessão do operador.
    • Os eventos da ligação chegam ao vivo por SSE (eventos enviados pelo servidor).
    • Ao tocar, mostra o cartão de quem liga (screen pop) antes de atender.
  • CRM → barra

    Do CRM para a ligação

    • O CRM envia à barra o contexto da ficha e o roteiro da campanha.
    • O ekovox Cob-Copilot, Sales-Copilot e SAC-Copilot recebem roteiro e checklist por campanha.
    • Pausas e ocorrências vêm do cadastro do CRM.
  • CRM → plataforma

    Do CRM para a plataforma

    • O backend do CRM chama com a chave de API do cliente.
    • API REST descrita em OpenAPI 3.1, com erros em JSON e código estável.
    • Ramais provisionados por API, em chamada idempotente.
    • Operadoras, troncos e números cadastrados por API, com trilha.
    • Respostas 429 e 503 trazem o tempo de espera (Retry-After).
  • Plataforma → CRM

    Da plataforma para o CRM

    • No fim da ligação, o webhook leva o desfecho e o link da gravação.
    • O desfecho técnico de cada tentativa é tabulado no CRM, com de-para por cliente.
    • Assinatura HMAC-SHA256, com chave gerada pela plataforma e trocável.
    • Fila de entrega durável, idempotência por evento e reenvio manual pelo administrador.

Responsabilidade do dado

O CRM guarda a ficha. A plataforma conduz a ligação.

A tabulação chega preenchida pelo Copilot conforme a conversa anda, mas quem confere e grava é o operador, no CRM. A transcrição fica só na memória do serviço, por tempo curto: depois disso, existe só onde o CRM a guardou.

O CRM guarda a ficha. A plataforma conduz a ligação.
DadoComo chega ao CRMQuem guarda
TabulaçãoPreenchida na barra; o operador confere e gravaCRM
Desfecho da ligação e link da gravaçãoWebhook assinadoCRM
Desfecho técnico de cada tentativa do discadorTabulado no CRM, com o de-para do clienteCRM
Transcrição por falante, resumo e nota de qualidadePela barra, sob demanda, com a sessão do operadorCRM
GravaçãoLink assinado de curta duração, ouvida pela sessão do usuárioPlataforma, no prazo em dias que o cliente define, ou o armazenamento (bucket) do próprio cliente
Ficha, carteira e históricoFicam no CRM; a barra recebe só o contexto que o CRM enviaCRM

Sistemas integrados

Agrupados pelo papel do sistema na operação.

Cada grupo em ordem alfabética.

Sistema do contratante

Para quem cobra para terceiros e trabalha no sistema de quem a contratou

  • Celcoin
  • CobranSaaS
  • Cyber Financial Solutions
  • Recupera Crédito
  • revo360
  • SisCobra

CRM de cobrança

Carteira, acordo e boleto

  • revo360

CRM de vendas

Lead, negócio e funil

  • revo360

CRM de SAC

Chamado e atendimento

  • revo360

O seu CRM não está aqui? A barra entra em qualquer CRM com página web. O que a integração faz no seu caso, como o contexto enviado à barra e o de-para do desfecho, entra no escopo da implantação.

Como funciona a implantação

Operadora e telefonia

A operadora da operação entra pela borda SIP.

A operadora SIP é ativada por ficha na implantação e entra só pela borda SIP, que confere o IP de origem. Operadoras, troncos e números ficam cadastrados por API, com trilha. O número de A (o que aparece para quem recebe a ligação) segue o formato da operadora; na transferência externa, aparece o da operação, nunca o do consumidor.

A posição que usa telefone de mesa pode mantê-lo: no modo controlador, a barra comanda o aparelho.

Credenciais

Duas identidades, cada uma com um papel.

  • Sessão do operador: liga, atende e ouve a gravação; é revogável no ato.

  • Chave de API do cliente: integra o backend do CRM e não disca.

  • Nenhuma das duas aceita escolher o cliente (tenant) por parâmetro.

  • A barra esconde o que o operador não tem permissão para fazer.

Perguntas frequentes

Preciso abrir o banco do meu CRM para o ekovox?

Não. A barra roda na página do CRM e fala com a plataforma só por REST, e a plataforma devolve o desfecho e o link da gravação por webhook assinado. O ekovox nunca escreve no banco do CRM: o operador grava a tabulação no CRM, e a transcrição e o histórico ficam onde o CRM os guarda.

Meu CRM não aparece entre os logotipos. Ele pode receber a barra?

Pode, se tiver uma página web onde a barra entre como componente e um endereço que receba o webhook. O que a integração faz no seu caso, como o contexto enviado à barra, o roteiro por campanha e o de-para do desfecho, entra no escopo da implantação.

E se o CRM estiver fora do ar quando a ligação terminar?

A entrega fica numa fila durável. A cada falha, a espera até a nova tentativa dobra, até 1 hora, e a plataforma desiste depois de 24 horas sem entrega. O administrador pode reenviar o aviso. Uma resposta 3xx ou 4xx, exceto 408 e 429, encerra a entrega como recusada.

A transcrição chega pelo webhook?

Não. A transcrição, o resumo e a nota de qualidade chegam ao CRM pela barra, sob demanda, com a sessão do operador. A transcrição fica só na memória do serviço, por tempo curto; depois disso, existe só onde o CRM a guardou. O webhook leva o desfecho e o link da gravação.

Como a operadora entra na integração?

A operadora SIP da operação é ativada por ficha na implantação e entra pela borda SIP, que confere o IP de origem. Troncos e números são cadastrados por API, com trilha. A cifra no trecho entre a plataforma e a operadora depende do suporte dela e é combinada na ativação.

Para o comitê

O que cada cadeira confere antes de decidir.

O que cada cadeira confere antes de decidir.
CadeiraO que conferirOnde conferir
Operações (COO)Discador ativo e supervisão em tempo real por campanha: estado de cada operador, quem espera, nível de serviço, ASA (tempo médio até atender), TMA (tempo médio de atendimento) e abandono.
Financeiro (CFO)Contratação por posição de atendimento, sem preço publicado, dimensionada com a operação.
TI e segurança (CTO)A barra fala só por REST, o webhook é assinado e há duas identidades: a sessão do operador e a chave de API, que não disca. Ambiente dedicado, implantado por cliente, para quem exige isolamento.
Jurídico e DPOGravação ouvida por link assinado, registro de quem ouviu e retenção no prazo de cada cliente; a IA só entra com as guardas da plataforma.
SupervisãoO Copilot sugere e preenche a tabulação; quem grava é o operador.
ComprasImplantação com escopo próprio; contratação sem preço publicado.

Próximo passo

Leve a voz para dentro do seu CRM.

Conte qual CRM a operação usa, quantas posições de atendimento tem e com que operadora trabalha. Um engenheiro de telefonia responde com as perguntas de rede e de operadora.