> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.callix.dev.br/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.callix.dev.br/_mcp/server.

# SDK Callix — visão geral

O SDK da Callix coloca o telefone dentro da aplicação do cliente. O agente atende, disca, coloca em espera e qualifica a chamada sem sair da tela onde já trabalha — e o áudio trafega pelo próprio browser, sem instalação de softphone, plugin ou VPN na máquina dele.

Tecnicamente, é um softphone WebRTC distribuído como biblioteca, com uma máquina de estados de operador em volta. A aplicação parceira constrói a interface que quiser; a Callix entrega a telefonia, o estado do agente e o contexto da chamada.

> **Note**
>
> **A divisão de responsabilidades.** A aplicação parceira assume a construção da interface de atendimento e, com isso, ganha o controle total dela — o que aparece na tela durante a chamada, onde o telefone fica, o que é gravado no banco próprio quando a ligação termina. A Callix assume a telefonia, a máquina de estados e o contexto operacional.

## Capacidades

#### Voz no browser

Chamada de entrada e de saída por WebRTC, sem instalar nada na estação do agente.

#### Estado do operador

Disponível, em pausa, offline, tocando, em chamada, pós-atendimento — empurrado em tempo real.

#### Controles de chamada

Iniciar, atender, rejeitar, desligar, colocar e tirar de espera, mudo de entrada e de saída, volume.

#### Contexto de campanha

A chamada de campanha chega com o contato já resolvido: campanha, lista e todos os campos do contato — cada um com nome, tipo e valor.

#### Pausas do tenant

As pausas configuradas na plataforma chegam prontas, com id e nome, para montar o seletor.

#### Qualificação

Listas de qualificação de sucesso e de descarte, e o encerramento do pós-atendimento.

## O problema que resolve

Sem SDK, o agente opera em duas telas: o sistema onde estão o cliente e o histórico, e a tela de operação da Callix, onde está o telefone. Ele copia número de um lado para o outro, alterna janelas durante a ligação e registra o desfecho duas vezes — uma na qualificação da Callix, outra no sistema próprio. Erro de digitação e registro esquecido nascem nessa fronteira.

```mermaid
%%{init: {'theme': 'dark', 'flowchart': {'nodeSpacing': 60, 'rankSpacing': 70}}}%%
flowchart LR
  subgraph SEM["SEM SDK — o agente é a integração"]
    direction TB
    A1["Sistema do parceiro<br />cliente, histórico, contrato, ticket"]
    A2["Tela da Callix<br />telefone, pausas, qualificação"]
    A1 -. "copia nº · alt-tab" .-> A2
    A2 -. "registra de novo" .-> A1
  end
  subgraph COM["COM O SDK — uma tela só"]
    direction TB
    B1["Sistema do parceiro<br />cliente, histórico, contrato, ticket"]
    B2["SDK<br />telefone + estado"]
    B2 --> B1
  end
  SEM ==> COM
```

A diferença não é estética: sem SDK, o agente humano é o mecanismo de integração entre os dois sistemas. Com o SDK, o parceiro decide onde o telefone fica, o que aparece durante a chamada e o que grava no próprio banco quando ela termina.