POST /send-product

Envia um card de produto do catálogo Meta Commerce. O cliente vê uma prévia com foto/título/preço; ao tocar, abre o catálogo completo no WhatsApp.

Campo	Valor
URL	`https://api.wevi.chat/functions/v1/send-product`
Método	`POST`
Auth	`Authorization: Bearer wevi_...`
Content-Type	`application/json`
Rate limit	60 req/min por API key
Plano necessário	Pro ou Ultra
Pré-requisito	Conexão WhatsApp com `catalog_id` configurado

Pré-requisitos

Formato de erro. Desde 8 de setembro de 2026, os erros deste endpoint saem no envelope padrão: error é um código estável (missing_connection_id) e a frase que você já conhecia (missing_connection_id) vai em message. O corpo de sucesso não mudou. A chave de teste wevi_test_ passou a valer aqui também.

Catálogo configurado no Meta Commerce Manager com produtos da sua loja.
catalog_id informado na conexão WhatsApp da sua org:
- Vá em Conta → Conectores → WhatsApp.
- Na conexão desejada, clique em configurar ao lado de "Catálogo".
- Cole o catalog_id do Meta Commerce. Salve.
product_retailer_id: identificador único do produto no seu sistema (SKU, ID interno) — é o mesmo que foi enviado ao Meta no upload do catálogo.

Body

Campo	Tipo	Obrigatório	Descrição
`connection_id`	string (uuid)	sim	ID da conexão WhatsApp.
`to`	string	sim	Telefone destino.
`product_retailer_id`	string	sim	SKU/ID do produto no catálogo.
`body`	string	não	Texto curto acima do card. Max 1024.
`footer`	string	não	Rodapé. Max 60.
`contact_id`	string (uuid)	não	Vincula ao contato.
`idempotency_key`	string	não	Idempotência.

Exemplo

curl -X POST https://api.wevi.chat/functions/v1/send-product \
  -H "Authorization: Bearer wevi_abc..." \
  -H "Content-Type: application/json" \
  -d '{
    "connection_id": "conn-uuid",
    "to": "+5511999999999",
    "product_retailer_id": "SKU-12345",
    "body": "Esse modelo combina com o que você procurava 😉"
  }'

await fetch("https://api.wevi.chat/functions/v1/send-product", {
  method: "POST",
  headers: { "Authorization": "Bearer wevi_abc...", "Content-Type": "application/json" },
  body: JSON.stringify({
    connection_id: "conn-uuid",
    to: "+5511999999999",
    product_retailer_id: "SKU-12345",
    body: "Esse modelo combina com o que você procurava 😉",
  }),
});

Resposta

Sucesso (200)

{ "id": "envio-uuid", "wamid": "wamid.HBgN...", "status": "sent" }

Erros principais

Status	`error`
400	`missing_connection_id`, `missing_to`, `missing_product_retailer_id`
401	`invalid_api_key`
403	`catalog_not_configured` (conexão sem `catalog_id`)
404	`connection_not_found`

Pra múltiplos produtos

Use `POST /send-product-list` que aceita até 30 produtos em 10 seções.

/send-product-list

→