WAHA (WhatsApp Integration)

Gerencie sessoes WAHA para integracao self-hosted com WhatsApp. Controle conexao, QR code, configuracoes de webhook e tracking de conversoes Meta.

WAHA

WAHA (WhatsApp HTTP API) e a solucao self-hosted para conectar o WhatsApp ao NooviChat. Cada inbox WhatsApp possui uma sessao WAHA associada.

Status da Sessao

GET/api/v1/accounts/{account_id}/waha/{inbox_id}/status

Verifica o status da sessao WAHA de uma inbox.

bash

curl -s "https://chat.seudominio.com/api/v1/accounts/1/waha/3/status" \
  -H "api_access_token: YOUR_TOKEN" | jq .

200Status da sessao

json

{
  "status": "working",
  "qr_code": null,
  "config": {},
  "phone_number": "+5511999887766",
  "session_name": "inbox_Empresa_XYZ_abc123"
}

QR Code

POST/api/v1/accounts/{account_id}/waha/{inbox_id}/refresh_qr

Gera um novo QR code para conectar o WhatsApp.

bash

curl -X POST "https://chat.seudominio.com/api/v1/accounts/1/waha/3/refresh_qr" \
  -H "api_access_token: YOUR_TOKEN"

200QR code gerado

json

{
  "data": {
    "qr_code": "data:image/png;base64,iVBORw0KGgo...",
    "expires_at": "2026-02-15T10:05:00Z"
  }
}

Gerenciar Conexao

POST/api/v1/accounts/{account_id}/waha/{inbox_id}/start

Inicia a sessao WAHA.

POST/api/v1/accounts/{account_id}/waha/{inbox_id}/stop

Para a sessao WAHA.

POST/api/v1/accounts/{account_id}/waha/{inbox_id}/reconnect

Reconecta uma sessao desconectada.

POST/api/v1/accounts/{account_id}/waha/{inbox_id}/disconnect

Desconecta a sessao do WhatsApp (mantendo a sessao WAHA).

Atencao

Desconectar requer novo escaneamento de QR code para reconectar.

Configuracao WAHA

PATCH/api/v1/accounts/{account_id}/waha/{inbox_id}/config

Atualiza configuracao da sessao WAHA.

Body

Nome	Tipo	Obrigatorio	Descricao
`config`	`object`	Sim	Objeto de configuracao contendo os campos a atualizar
`config.proxy`	`string`	Nao	URL do proxy
`config.webhook_url`	`string`	Nao	URL do webhook

Configuracoes Detalhadas

Em Desenvolvimento

O endpoint GET settings esta em desenvolvimento e pode retornar erro em algumas instalacoes. Use os endpoints individuais (chatwoot_app, session, webhook) para configuracoes especificas.

GET/api/v1/accounts/{account_id}/waha/{inbox_id}/settings

Retorna todas as configuracoes da sessao WAHA.

PATCH/api/v1/accounts/{account_id}/waha/{inbox_id}/settings/chatwoot_app

Atualiza configuracoes de integracao Chatwoot.

Body

Nome	Tipo	Obrigatorio	Descricao
`api_url`	`string`	Nao	URL da API Chatwoot
`token`	`string`	Nao	Token de acesso
`inbox_id`	`integer`	Nao	ID da inbox

PATCH/api/v1/accounts/{account_id}/waha/{inbox_id}/settings/session

Atualiza configuracoes da sessao.

PATCH/api/v1/accounts/{account_id}/waha/{inbox_id}/settings/webhook

Atualiza configuracoes de webhook.

Meta Tracking

Configure o rastreamento de conversoes do Meta (Facebook/Instagram) para atribuir conversas WAHA a campanhas de anuncios.

PATCH/api/v1/accounts/{account_id}/waha/{inbox_id}/settings/meta_tracking

Atualiza configuracoes de tracking Meta.

Body

Nome	Tipo	Obrigatorio	Descricao
`pixel_id`	`string`	Nao	ID do pixel Meta
`access_token`	`string`	Nao	Token de acesso Meta CAPI
`enabled`	`boolean`	Nao	Ativar tracking