Conectar por QR Code
Inicie a conexão e obtenha o QR Code da instância.
/functions/v1/erp-whatsapp-bridgeconnectBearer AuthKeyCabeçalhos obrigatóriosAuthKey + JSON
AuthorizationBearer SUA_AUTHKEYContent-Typeapplication/jsonCorpo da requisiçãoJSON
Envie os campos abaixo junto com a ação da operação.
_actionstringObrigatórioIdentifica a operação neste endpoint. Use "connect".
instance_idstringOpcional*UUID da instância retornado pela API. Informe este campo ou appkey; não use o ID do dispositivo no seu banco.
appkeystringOpcional*Nome da instância retornado em instance_name. Alternativa ao instance_id.
force_refreshbooleanOpcional*Quando true, força uma nova tentativa de conexão. Use com cuidado em uma sessão ativa.
* Condições e alternativas estão descritas em cada campo. Quando necessário, selecione a instância por instance_id ou appkey. Um array de destinos pode substituir phone nos envios.
Comportamento e cuidados
- Informe instance_id ou appkey. Nos exemplos sempre selecionamos explicitamente uma instância da empresa autenticada.
- O QR é sensível e temporário: não registre em logs públicos. O marcador da resposta é ilustrativo, não um QR funcional. Consulte status até confirmar connected. Uma instância já conectada pode retornar qr_code=null.
Tratamento de falhas
Confira o HTTP e os campos da resposta. Em falhas, preserve code e request_id para diagnóstico. HTTP 200 e success=true nem sempre significam envio completo ou exclusão confirmada.