Abrir ponte WebSocket de áudio

Upgrade WebSocket. PCM s16le mono 16 kHz binário nos dois sentidos; origem validada por ATENDROZAP_CALLS_AUDIO_ORIGINS. Aceita token no header ou na query somente nesta rota. O console faz proxy com o header e guarda o token fora do navegador. Fechar o socket encerra a chamada; um segundo socket substitui o primeiro. Códigos 4000 encerrada, 4001 PCM ímpar, 4002 falha de escrita, 4003 substituído.

Autenticação

Header aceito: token. Use o token da instância.

Alternativa exclusiva desta ponte: ?token=. O proxy do console usa o header no backend; prefira esse fluxo para manter a credencial fora do navegador. Não registrar a query.

Base URL: a API do servidor selecionado, como https://1.atendro.cloud. O domínio wpp.atendro.cloud hospeda a documentação e o console.

Parâmetros de caminho

Campo	Tipo	Presença	Descrição
`id`	`string`	obrigatório	callId retornado pela API. Comprimento mínimo: `1`

Headers adicionais

Campo	Tipo	Presença	Descrição
`X-Request-Id`	`string`	opcional	ASCII visível sem espaços, 1–128 caracteres. Inválido/ausente é substituído por UUID. Ecoado na resposta. Comprimento máximo: `128`

Corpo da requisição

Não há corpo de requisição definido para esta operação.

Respostas

WebSocket estabelecido; mensagens binárias PCM.

Upgrade WebSocket inválido.

Campo	Tipo	Presença	Descrição
`error`	`string`	obrigatório	—
`message`	`string`	opcional	—
`messageid`	`string`	opcional	ID para reconciliação quando o resultado é ambíguo.
`messageId`	`string`	opcional	—
`id`	`string`	opcional	—
`provider_code`	`integer`	opcional	—
`error_key`	`string`	opcional	—
`error_source`	`string`	opcional	—
`details`	`object`	opcional	—
`instance`	`object`	opcional	Modelo: Instance.

unauthorized: header ausente, inválido ou duplicado. Bearer/query/instancekey não substituem admintoken/token.

Campo	Tipo	Presença	Descrição
`error`	`string`	obrigatório	—
`message`	`string`	opcional	—
`messageid`	`string`	opcional	ID para reconciliação quando o resultado é ambíguo.
`messageId`	`string`	opcional	—
`id`	`string`	opcional	—
`provider_code`	`integer`	opcional	—
`error_key`	`string`	opcional	—
`error_source`	`string`	opcional	—
`details`	`object`	opcional	—
`instance`	`object`	opcional	Modelo: Instance.

Origem de navegador não autorizada.

Campo	Tipo	Presença	Descrição
`error`	`string`	obrigatório	—
`message`	`string`	opcional	—
`messageid`	`string`	opcional	ID para reconciliação quando o resultado é ambíguo.
`messageId`	`string`	opcional	—
`id`	`string`	opcional	—
`provider_code`	`integer`	opcional	—
`error_key`	`string`	opcional	—
`error_source`	`string`	opcional	—
`details`	`object`	opcional	—
`instance`	`object`	opcional	Modelo: Instance.

call_not_found.

Campo	Tipo	Presença	Descrição
`error`	`string`	obrigatório	—
`message`	`string`	opcional	—
`messageid`	`string`	opcional	ID para reconciliação quando o resultado é ambíguo.
`messageId`	`string`	opcional	—
`id`	`string`	opcional	—
`provider_code`	`integer`	opcional	—
`error_key`	`string`	opcional	—
`error_source`	`string`	opcional	—
`details`	`object`	opcional	—
`instance`	`object`	opcional	Modelo: Instance.

wrong_instance_kind, not_connected, owned_elsewhere ou invalid_call_state; conferir error.

Campo	Tipo	Presença	Descrição
`error`	`string`	obrigatório	—
`message`	`string`	opcional	—
`messageid`	`string`	opcional	ID para reconciliação quando o resultado é ambíguo.
`messageId`	`string`	opcional	—
`id`	`string`	opcional	—
`provider_code`	`integer`	opcional	—
`error_key`	`string`	opcional	—
`error_source`	`string`	opcional	—
`details`	`object`	opcional	—
`instance`	`object`	opcional	Modelo: Instance.

calls_not_supported: módulo desligado; /call/make também recusa instância whatsapp.

Campo	Tipo	Presença	Descrição
`error`	`string`	obrigatório	—
`message`	`string`	opcional	—
`messageid`	`string`	opcional	ID para reconciliação quando o resultado é ambíguo.
`messageId`	`string`	opcional	—
`id`	`string`	opcional	—
`provider_code`	`integer`	opcional	—
`error_key`	`string`	opcional	—
`error_source`	`string`	opcional	—
`details`	`object`	opcional	—
`instance`	`object`	opcional	Modelo: Instance.

Falha; usar HTTP status e error. 404 rota inexistente; 405 método inválido com Allow. Ver catálogo no guia de integração.

Campo	Tipo	Presença	Descrição
`error`	`string`	obrigatório	—
`message`	`string`	opcional	—
`messageid`	`string`	opcional	ID para reconciliação quando o resultado é ambíguo.
`messageId`	`string`	opcional	—
`id`	`string`	opcional	—
`provider_code`	`integer`	opcional	—
`error_key`	`string`	opcional	—
`error_source`	`string`	opcional	—
`details`	`object`	opcional	—
`instance`	`object`	opcional	Modelo: Instance.

// github.com/coder/websocket; credencial somente no backend. endpoint, err := url.Parse(os.Getenv("ATENDROZAP_URL")) if err != nil { return err } endpoint.Path = "/call/" + os.Getenv("CALL_ID") + "/audio" endpoint.Scheme = "wss" conn, _, err := websocket.Dial(ctx, endpoint.String(), &websocket.DialOptions{ HTTPHeader: http.Header{"token": {os.Getenv("ATENDROZAP_INSTANCE_TOKEN")}}, }) if err != nil { return err } defer conn.CloseNow() // Enviar e receber mensagens binárias PCM s16le, mono, 16 kHz. // No navegador, usar a ponte autenticada do console para manter o token privado.