Conectar por código
Solicite um código de vinculação para conectar o WhatsApp pelo telefone.
/functions/v1/erp-whatsapp-bridgepair-phoneBearer AuthKeyConfirme a instância ou o agendamento antes de executar. Evite repetir a operação sem conferir o resultado anterior.
Cabeç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 "pair-phone".
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.
phonestringObrigatório*Telefone da conta WhatsApp que será conectada, com DDI, somente dígitos.
* 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.
- Essa operação reinicia o pareamento da sessão selecionada. Não a use como consulta de status.
- Informe o código no WhatsApp em Aparelhos conectados. Não compartilhe nem persista o código em logs. A vinculação só termina quando status confirmar connected.
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.