Envio de mensagens

Envia uma mensagem de texto via WhatsApp (UAZAPI ou Meta Cloud). O campo `to` aceita um telefone ou o código de um grupo ou comunidade do WhatsApp (`<id>@g.us`).

• Envio para grupo: use em `to` o código do grupo, por exemplo `{ "to": "120363322649858630@g.us", "message": "Bom dia, pessoal!" }`. O código aparece em `external_chat_id` de GET /api/v1/contacts?is_group=true. A resposta traz também `group_jid` com o grupo que recebeu a mensagem.
• Envio para comunidade: use em `to` o código da comunidade, por exemplo `{ "to": "120363302307113947@g.us", "message": "Aviso para todos" }`. A mensagem vai para o grupo de avisos da comunidade, e `group_jid` na resposta traz o código desse grupo de avisos.
• Grupo e comunidade só saem por conexão UAZAPI ativa e conectada cujo número participa do grupo; conexão pela API oficial da Meta não envia para grupos. Sem `connection_id`, a API usa a única conexão que participa do grupo; se houver mais de uma, usa a última conexão em que o grupo conversou e, sem ela, responde 422 `CONNECTION_REQUIRED` para você escolher.
• Um grupo de que o número da conexão já saiu ainda pode aparecer como grupo da empresa: nesse caso o provedor recusa e a resposta é 502 `PROVIDER_ERROR` com o detalhe do provedor.

{
  "to": "5548999990000",
  "message": "Olá! Seu pedido foi confirmado.",
  "connection_id": "<opcional — UUID da conexão>"
}

{
  "success": true,
  "data": {
    "wamid": "<id-da-meta-ou-provider>",
    "provider": "uazapi",
    "message_id": "<uuid>",
    "contact_id": "<uuid>"
  }
}

curl -s -X POST -H "Authorization: Bearer <sua-key>" -H "Content-Type: application/json" \
  -d '{"to":"5548999990000","message":"Olá! Seu pedido foi confirmado.","connection_id":"<opcional — UUID da conexão>"}' \
  https://www.prosalab.com/api/v1/send/message

Envia uma mensagem de template/HSM aprovado na Meta Cloud. Template com variável (corpo, cabeçalho ou botão de URL) exige o array components — sem ele a Meta recebe o template sem preenchimento.

• components é repassado à Meta EXATAMENTE como enviado — esta rota não monta, valida nem completa nenhum componente. Template com variável enviado sem components chega à Meta sem preenchimento; a falha é da Meta, não desta rota.
• Botão de URL dinâmica: a Meta aceita UMA variável por botão, e apenas no FIM de uma URL já aprovada — o valor enviado em parameters[0].text é concatenado à base aprovada. index é a posição do botão no template ("0" para o primeiro), enviado como STRING. URL fora da base aprovada faz a Meta rejeitar o envio inteiro.
• Não há endpoint para listar templates aprovados, e template_name/language_code NÃO são validados contra o catálogo antes do envio. Nome inexistente, idioma errado ou template não aprovado só falham na Meta e voltam como 502 PROVIDER_ERROR genérico — confira o nome e o idioma no Gerenciador da Meta antes de disparar.
• Exige conexão WhatsApp Meta Cloud. Informando connection_id, ele PRECISA ser Meta Cloud; sem ele, a conexão Meta Cloud conectada da empresa é resolvida automaticamente. Conexão de outro tipo também volta como 502, não 400.
• A mensagem é gravada com o template_name usado no disparo, o que permite auditar e deduplicar envios por template.

{
  "to": "5548999990000",
  "template_name": "renovacao_proposta",
  "language_code": "pt_BR",
  "connection_id": "<opcional — UUID da conexão>",
  "components": [
    {
      "type": "body",
      "parameters": [
        {
          "type": "text",
          "text": "Maria"
        }
      ]
    },
    {
      "type": "button",
      "sub_type": "url",
      "index": "0",
      "parameters": [
        {
          "type": "text",
          "text": "aB3xK9"
        }
      ]
    }
  ]
}

{
  "success": true,
  "data": {
    "wamid": "<id-da-meta>",
    "provider": "meta_cloud",
    "message_id": "<uuid>",
    "contact_id": "<uuid>"
  }
}

curl -s -X POST -H "Authorization: Bearer <sua-key>" -H "Content-Type: application/json" \
  -d '{"to":"5548999990000","template_name":"renovacao_proposta","language_code":"pt_BR","connection_id":"<opcional — UUID da conexão>","components":[{"type":"body","parameters":[{"type":"text","text":"Maria"}]},{"type":"button","sub_type":"url","index":"0","parameters":[{"type":"text","text":"aB3xK9"}]}]}' \
  https://www.prosalab.com/api/v1/send/template