API ReferenceWavoip

Wavoip

Integração com WhatsApp via Wavoip — provisionamento, QR Code, dispositivos e chamadas.

Provisionar Dispositivo

POST
/api/wavoip/provision-device

Provisiona um dispositivo Wavoip gratuito

Se o usuário já tem um dispositivo ativo, retorna os dados dele. Caso contrário, cria um novo com rotas SIP configuradas.

Response
{
  "deviceUuid": "a1b2c3d4-...",
  "deviceId": "8750882",
  "alreadyExisted": false
}

Status do Dispositivo

GET
/api/wavoip/device-status

Verifica se o WhatsApp foi vinculado e retorna o número

Response
{
  "hasDevice": true,
  "connected": true,
  "phone": "+5511999887766",
  "deviceId": "8750882",
  "status": "connected"
}

Tip

Use este endpoint para verificar se o QR Code foi escaneado antes de vincular o agente.

Credenciais Wavoip

Salvar Credenciais

POST
/api/wavoip/credentials

Salva credenciais Wavoip do próprio usuário

ParameterTypeRequiredDescription
emailstringRequiredE-mail da conta Wavoip
passwordstringRequiredSenha da conta Wavoip

Obter Credenciais

GET
/api/wavoip/credentials

Credenciais salvas (sem a senha)

Remover Credenciais

DELETE
/api/wavoip/credentials

Remove credenciais salvas

Gerenciar Dispositivos

GET
/api/wavoip/devices

Listar dispositivos da conta

GET
/api/wavoip/devices/:id

Detalhes de um dispositivo

POST
/api/wavoip/devices

Adicionar novo dispositivo

PATCH
/api/wavoip/devices/:id

Atualizar configurações

DELETE
/api/wavoip/devices/:id

Remover dispositivo

Credenciais SIP

GET
/api/wavoip/sip/credentials

Credenciais SIP para registro

Iniciar Chamada via WhatsApp

POST
/api/wavoip/calls/outbound

Chamada outbound usando dispositivo Wavoip

ParameterTypeRequiredDescription
toNumberstringRequiredNúmero de destino
agentIdstringRequiredID do agente
deviceTokensstring[]OptionalTokens de dispositivos a usar

Gravações

GET
/api/wavoip/calls/recordings/:sessionId

Download da gravação de uma chamada