Pular para o conteúdo

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 é ativada
  • CRM

    Recebe a barra de atendimento dentro da própria tela e o desfecho de cada ligação por API.

    Como o CRM recebe a barra
  • Integrador

    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.

Falar com um engenheiro de telefonia

  • Tronco e IPs de origem da operadora, conferidos na borda SIP.
  • Número de A, o que aparece para quem recebe, configurado por tronco.
  • Formato do número no padrão que a operadora exige.
  • Operadoras, troncos e números cadastrados por API, com trilha de auditoria.
  • Em transferência externa, aparece o número da operação, nunca o do cliente em atraso.

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.

Falar com um engenheiro de telefonia

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.

Falar com um engenheiro de telefonia

Cabeçalho de assinatura do webhook

Content-Type: application/json
X-Idempotency-Key: 9f1c…e07a
X-Signature-256: sha256=4b7e…d2c9

Erro em JSON

HTTP/1.1 403
{
  "error": "permission_denied",
  "message": "your group (…) does not have the permission …",
  "permission": "…",
  "group": "…"
}
Exemplo ilustrativo; os nomes reais estão na especificação.

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. 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. 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. 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

  1. Contato

    Fale com um engenheiro de telefonia e diga, na mensagem, se a conversa é de operadora, CRM ou integrador.

  2. 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.

  3. 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ê

Para o comitê
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 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 DPOGravaçã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ãoO Copilot sugere e preenche a tabulação conforme a conversa anda; quem grava é o operador.
ComprasAtivaçã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.