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.
| Dado | Como chega ao CRM | Quem guarda |
|---|---|---|
| Tabulação | Preenchida na barra; o operador confere e grava | CRM |
| Desfecho da ligação e link da gravação | Webhook assinado | CRM |
| Desfecho técnico de cada tentativa do discador | Tabulado no CRM, com o de-para do cliente | CRM |
| Transcrição por falante, resumo e nota de qualidade | Pela barra, sob demanda, com a sessão do operador | CRM |
| Gravação | Link assinado de curta duração, ouvida pela sessão do usuário | Plataforma, no prazo em dias que o cliente define, ou o armazenamento (bucket) do próprio cliente |
| Ficha, carteira e histórico | Ficam no CRM; a barra recebe só o contexto que o CRM envia | CRM |
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éditorevo360
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çãoOperadora 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.
| Cadeira | O que conferir | Onde 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 DPO | Gravaçã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ão | O Copilot sugere e preenche a tabulação; quem grava é o operador. | |
| Compras | Implantaçã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.