Configurações da instância

curl -X PATCH -H "Authorization: Bearer <ADMIN_TOKEN>" -H "Content-Type: application/json" \
  -d '{"allowlist":["5583999999999"]}' \
  https://sua-instancia.exemplo/instance/{id}/settings

Corpo aceito (todos os campos opcionais — é um PATCH parcial):

Campo	Descrição
mode	hoje só sandbox é usado em produção interna
allowlist	lista de números (DDI+DDD+número) para onde a instância pode enviar
minIntervalS	intervalo mínimo entre envios, em segundos
dailyCap	teto de mensagens por dia

Allowlist é checada mesmo em dry-run

Confirmado ao vivo: mandar POST /instance/{id}/send/text para um número fora da allowlist falha com 403 mesmo sem confirm — ou seja, mesmo o preview (que não envia nada de verdade) já valida o destino contra a allowlist:

{
  "code": "forbidden",
  "message": "destino fora da allowlist da instância (modo sandbox)"
}

Isso significa que testar o preview de um número novo exige primeiro colocá-lo na allowlist.

Quem pode mudar o quê

• Admin — edita qualquer campo, sem restrição.
• Dono não-admin — só pode editar allowlist, e só pode aumentar minIntervalS (nunca diminuir). Mudar mode ou dailyCap, ou diminuir o intervalo, exige admin.

Essa assimetria é proposital: existe para dificultar que o próprio dono da instância afrouxe os limites anti-banimento por conta própria.