Callback Receptivo

atenção

Em desenvolvimento - ainda não disponível em produção

Endpoint utilizado por sistemas de telefonia (dialers) para notificar o CUBE sobre o recebimento de uma ligação receptiva. O CUBE encaminha o bilhete ao agente correspondente via WebSocket em tempo real.

info

Este endpoint utiliza autenticação via API Key. Certifique-se de enviar os headers X-Api-Key, X-Api-Secret e X-Client-Id em todas as requisições.

Endpoint

Método	URL
POST	https://{{url}}/cube/api/v3/integrator/vendor/inbound/callback

Exemplo de Corpo JSON

{
    "login": "agente01",
    "telefone": "11999990000",
    "idGravacao": "REC-20260001",
    "assunto": "Suporte técnico",
    "cpf": "12345678900",
    "protocolo": "20260000000001",
    "campanha": 42
}

Chave	Tipo	Obrigatório	Descrição
login	Texto	Sim	Login do agente destinatário do bilhete no CUBE.
telefone	Texto	Sim	Número de telefone do chamador.
idGravacao	Texto	Sim	Identificador da gravação da chamada no sistema de telefonia.
assunto	Texto	Não	Assunto ou motivo da chamada.
cpf	Texto	Não	CPF do cliente identificado pelo dialer.
protocolo	Texto	Não	Número de protocolo do atendimento (sem traço).
campanha	Numérico	Não	ID da campanha associada ao atendimento.

Exemplo de Resposta

{
    "code": 200,
    "message": "Response Success",
    "success": true
}

Chave	Descrição
code	Código HTTP da resposta.
message	Mensagem descritiva do resultado.
success	Indica se o bilhete foi encaminhado com sucesso.

Respostas

Status	Descrição
200	OK - Bilhete encaminhado ao agente com sucesso.
400	Campos obrigatórios ausentes (login, telefone ou idGravacao).
401	API Key, Secret ou Client ID inválidos.
429	Limite de requisições excedido.