Parceiros
Operadora pela borda SIP. CRM e integrador pela API.
A operadora SIP é ativada por ficha técnica e entra só pela borda SIP. O CRM e o integrador falam com a plataforma só por REST.
Tipos de parceria
Três formas de trabalhar com a plataforma.
Cada parceiro entra na plataforma por um ponto definido: a operadora pela borda SIP, o CRM e o integrador pela API. O cliente final é a operação a partir de 30 posições de atendimento (PAs) ou com volume massivo diário, em cobrança, vendas, SAC, retenção e jurídico.
Operadora SIP
Entrega tronco e números. A ativação segue uma ficha técnica, fechada na conversa com um engenheiro de telefonia.
Como a operadora é ativadaCRM
Recebe a barra de atendimento dentro da própria tela e o desfecho de cada ligação por API.
Como o CRM recebe a barraIntegrador
Conecta o CRM do cliente à plataforma pela API REST e pelos webhooks, avisos automáticos de sistema para sistema.
Como o integrador trabalha
Operadoras SIP
A operadora entra por um ponto só, com a origem conferida.
Cada operadora é ativada por uma ficha técnica, fechada na conversa com um engenheiro de telefonia. O tronco SIP, a conexão de voz com a operadora, chega só pela borda SIP da plataforma, que confere o IP de origem.
Até a plataforma, a mídia do operador segue cifrada. No trecho entre a plataforma e a operadora, a cifra depende do que a operadora suporta e é combinada na ativação. Para o cliente que exige ambiente de voz dedicado, implantado por cliente, IPs e operadora são ativados no projeto.
CRMs
O CRM recebe a barra e o desfecho, só por API.
A barra de atendimento é um componente web (Web Component) que entra na tela do CRM, herda o tema dele e fala com a plataforma só por REST. Ela nunca escreve no banco do CRM. No fim da ligação, o CRM recebe por webhook assinado o desfecho e o link da gravação.
- Webhook assinado, com idempotência por evento e fila de entrega durável.
- Desfecho técnico de cada tentativa tabulado no CRM, com de-para por cliente.
- Roteiro e checklist por campanha enviados pelo servidor do CRM ao ekovox.ia Copilot.
- Pausas e ocorrências da operação vêm do CRM.
- Transcrição e resumo chegam pela barra; quem guarda é o CRM.
Integradores
O integrador trabalha sobre uma especificação OpenAPI.
O integrador trabalha com a mesma API REST e os mesmos webhooks que o CRM recebe. A especificação segue OpenAPI 3.1, com documentação em inglês, português do Brasil e espanhol em duas variantes, América Latina e Espanha. Ela é enviada a pedido, pelo contato com um engenheiro de telefonia.
- Sessão do operador, revogável no ato, e chave de API, que não disca.
- Nenhuma das duas aceita parâmetro de cliente; o recorte vem da credencial.
- Erros em JSON com código estável; 429 e 503 respondem com Retry-After.
- Eventos ao vivo por SSE (eventos enviados pelo servidor), na sessão do operador.
- Cliente e ramais provisionados por API, numa chamada que pode repetir sem duplicar.
Cabeçalho de assinatura do webhook
Content-Type: application/json
X-Idempotency-Key: 9f1c…e07a
X-Signature-256: sha256=4b7e…d2c9Erro em JSON
HTTP/1.1 403
{
"error": "permission_denied",
"message": "your group (…) does not have the permission …",
"permission": "…",
"group": "…"
}Prova técnica
O parceiro confere o mecanismo antes da ativação.
Na conversa técnica, o time do parceiro confere com um engenheiro de telefonia três registros: como o webhook é assinado, como o cadastro de operadora fica rastreado e como cada ligação é diagnosticada na interconexão.
Assinatura do webhook
HMAC-SHA256 do corpo, com chave gerada pela plataforma, devolvida uma vez e trocável.
Trilha do cadastro
Operadoras, troncos e números cadastrados por API, com trilha de auditoria.
Diagnóstico da interconexão
CDR (registro detalhado de chamada) por perna da ligação e captura SIP.
Como começar
Uma conversa técnica antes de qualquer ativação.
Do contato à ativação, por tipo de parceria
1. Contato
Diga se a conversa é de operadora, CRM ou integrador
Operadora SIP: Entrega tronco e números
CRM ou integrador: Recebe a barra na própria tela ou conecta o CRM do cliente à plataforma
2. Conversa técnica
Operadora SIP: A conversa fecha a ficha técnica: tronco, IPs de origem, formato do número de A, números e cifra no trecho até ela
CRM ou integrador: A conversa define onde a barra entra e qual endereço recebe o webhook
3. Ativação com escopo
Combinado antes de entrar em operação
Operadora SIP: Cada ativação de operadora tem escopo próprio
CRM ou integrador: Cada integração de CRM tem escopo próprio
Contato
Fale com um engenheiro de telefonia e diga, na mensagem, se a conversa é de operadora, CRM ou integrador.
Conversa técnica
Com a operadora, a conversa fecha a ficha técnica: tronco, IPs de origem, formato do número de A, números e cifra no trecho até ela. Com o CRM ou o integrador, define onde a barra entra e qual endereço recebe o webhook.
Ativação com escopo
Cada ativação de operadora e cada integração de CRM têm escopo próprio, combinado antes de entrar em operação.
Perguntas frequentes
Como a operadora entra na plataforma?
Só pela borda SIP da plataforma, que confere o IP de origem. A ficha técnica de ativação registra tronco, IPs de origem, formato do número de A e números. A cifra no trecho até a operadora depende do que ela suporta e é combinada na ativação.
O CRM precisa dar acesso ao banco de dados?
Não. A barra fala com a plataforma só por REST e nunca escreve no banco do CRM. O desfecho e o link da gravação chegam ao CRM por webhook assinado, com idempotência por evento e fila de entrega durável. Quem guarda a transcrição e a tabulação é o CRM.
Como o CRM confere que o webhook veio da plataforma?
Pela assinatura HMAC-SHA256 do corpo, com chave gerada pela plataforma, devolvida uma única vez e trocável. Se a entrega falhar, a fila tenta de novo com espera que dobra a cada falha, até 1 hora, e desiste após 24 horas sem entrega. O administrador pode reenviar manualmente.
O integrador tem acesso à documentação da API?
Sim, a pedido. A especificação segue OpenAPI 3.1, e a documentação está em inglês, português do Brasil e espanhol em duas variantes, América Latina e Espanha. Peça pelo contato com um engenheiro de telefonia, dizendo qual CRM será integrado.
Como uma empresa se torna parceira?
Pelo contato com um engenheiro de telefonia, dizendo na mensagem se a conversa é de operadora, CRM ou integrador. A conversa técnica vem antes de qualquer ativação, e cada ativação de operadora ou integração de CRM tem escopo próprio.
Para o comitê
| 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 operadora entra só pela borda SIP, com IP de origem conferido. A barra fala só por REST e nunca escreve no banco do CRM. O webhook é assinado, e a chave de API não disca. Ambiente dedicado, implantado por cliente, para quem exige isolamento. | |
| Jurídico e DPO | Gravação ouvida por link assinado, com trilha 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 conforme a conversa anda; quem grava é o operador. | |
| Compras | Ativação de operadora e integração de CRM com escopo próprio; contratação sem preço publicado. |
Próximo passo
Traga a operadora, o CRM ou a integração para a conversa técnica.
Diga o tipo de parceria e o que você entrega hoje. Um engenheiro de telefonia responde com as perguntas de rede, de operadora e de integração.