Iniciar conversa com um contato novo
Único jeito de falar com alguém que nunca conversou com a empresa — acha ou cria o cliente pelo telefone, cria (ou reaproveita, se já houver uma aberta) a conversa, e envia a primeira mensagem.
Fora da janela de 24h de atendimento do WhatsApp, só send_type: template funciona — a Meta rejeita texto livre pra quem nunca recebeu mensagem sua. Use GET /wba/templates?status=APPROVED pra listar os templates aprovados disponíveis.
Cumprir a política de uso da Meta (destinatário deu opt-in, etc.) é responsabilidade de quem integra — a Nupapia repassa o erro da Meta tal como veio, sem validação própria.
Se a Meta recusar o envio, o cliente e a conversa continuam existindo (resposta 502 com os ids) — dá pra tentar de novo na mesma conversa via POST /chat/conversations/{id}/wba-send-template ou POST /chat/conversations/{id}/messages.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Canal de WhatsApp da empresa — veja GET /company/{id}/channels.
"+5511999999999"
template, text Obrigatório se send_type=template.
"pt_BR"
Atalho pras variáveis do template — mapa {"1": "valor"}.
Obrigatório se send_type=text. Só funciona dentro da janela de 24h.