Callix Client SDK

O @callixbrasil/client-sdk é a biblioteca principal do cliente Callix, contendo as definições de tipos e a lógica central de comunicação com os serviços da Callix Brasil (gerenciamento de chamadas, campanhas e interações com clientes).

Em aplicações React, prefira utilizar o @callixbrasil/client-sdk-react, que oferece hooks e um provider construídos sobre este pacote.

Utilização

O token de sessão do usuário (userSessionToken) deve ser gerado no seu servidor com o @callixbrasil/server-sdk e enviado para o cliente.

import { CallixClientSdk } from '@callixbrasil/client-sdk';

const callixClientSdk = new CallixClientSdk({
  domain: 'seu-dominio.callix.com.br',
  userSessionToken: 'token-recebido-do-seu-servidor',
});

const callOperator = callixClientSdk.createCallOperator();

O CallOperator retornado por createCallOperator() gerencia o ciclo de vida do operador de chamadas (status, chamada atual, áudio, etc). Em aplicações React, essas informações ficam disponíveis de forma reativa através dos hooks do @callixbrasil/client-sdk-react.

Caso a inicialização do operador falhe (por exemplo, permissão de microfone negada, limite de usuários simultâneos atingido ou usuário já conectado em outro dispositivo), o sinal callOperator.startupError passa a expor o motivo (CallOperatorStartupError), permitindo que a aplicação exiba uma mensagem adequada para cada caso.