Telefones e instâncias
Identifique a conta de envio e o destinatário sem misturar os IDs do seu sistema com os da API.
Selecione a instância explicitamente
Prefira instance_id com o UUID retornado por list/create-instance. appkey é uma alternativa e representa instance_name, não um segredo. A instância deve pertencer à empresa da AuthKey.
Use require_instance=true nos envios. Sem seleção explícita, alguns envios podem escolher a primeira instância conectada; agendamento exige seleção. Nunca dependa desse fallback para separar empresas ou sistemas.
Informe DDI + DDD + número
Envie apenas dígitos, por exemplo um número brasileiro com 55 + DDD + número. O backend normaliza números nacionais brasileiros de 10/11 dígitos e pode resolver formas reconhecidas pelo WhatsApp.
Não insira ou remova o nono dígito por conta própria, não invente um JID de aparelho e não interprete a máscara visual do telefone como identificador de destino. Para números de outros países use o DDI correto; a normalização nacional é brasileira.
Múltiplos destinatários e sucesso parcial
Nas operações de texto, mídia e agendamento você pode trocar phone por para, to ou recipients como array. Evite misturar formas em uma mesma requisição: arrays têm precedência sobre o destino escalar.
Texto/mídia podem retornar success=true quando apenas parte do lote foi aceita. Compare sent com total e considere quarantined. Não reenvie o lote inteiro automaticamente, pois isso pode duplicar mensagens para quem já recebeu.