Canal e catálogo do WhatsApp

Esta seção reúne o que o seller configura em volta da conversa: quando atende (horário), o que aparece no catálogo nativo do WhatsApp, quais modelos de mensagem pode usar para falar primeiro com o cliente e como é a mini-loja aberta por link.

Quatro conceitos novos:

• Catálogo da Meta: uma lista de produtos publicada no Gerenciador de Catálogo da Meta, que o WhatsApp mostra dentro da conversa. A plataforma copia os produtos do seller para lá (só no sentido plataforma para Meta).
• Modelo de mensagem (template): texto pré-aprovado pela Meta. É a única forma de iniciar uma conversa, ou de falar com o cliente depois de 24 horas sem resposta dele.
• Pacote de links (link pack): os links personalizados da mini-loja (loja, carrinho, checkout) de um cliente.
• Mini-loja: uma página web leve de compra aberta por um link dentro do WhatsApp, reconhecendo o cliente pelo telefone.

Como funciona

Do produto ao cliente

1. Informar o catálogo

   POST /catalog-sync/enable valida na Meta o id do catálogo e liga a sincronização.

2. Enviar os produtos

   POST /catalog-sync/full envia os produtos visíveis, em lotes de até 200 por chamada. Um processo automático também atualiza de hora em hora.

3. Acompanhar

   GET /catalog-sync/products mostra, produto a produto, se o envio deu certo e o motivo de uma falha.

Janela de 24 horas e modelos

Dentro de 24 horas depois da última mensagem do cliente, o seller envia o que quiser. Depois disso, só um modelo aprovado. A rota Enviar a mini-loja escolhe sozinha o melhor caminho: botão com link dentro da janela, modelo fora dela.

Endpoints

Auth: Seller é um usuário do painel do seller (Authorization: Bearer $TOKEN).

Erros comuns

• Ligar o catálogo sem número próprio. catalog-sync/enable exige a credencial do número do seller com token. Sem ela: 400.
• Achar que full envia tudo. Cada chamada processa no máximo 200 produtos. Repita até pushed e failed ficarem em zero.
• Confundir pushed com "produtos novos". O número também conta produtos retirados da Meta porque saíram do catálogo visível.
• Mudar horário esperando efeito imediato. Os valores do seller são guardados e devolvidos, mas hoje o atendimento automático não os consulta.
• Mexer na aparência da mini-loja como se fosse só sua. A configuração é única para a loja.
• Mandar a mini-loja a um cliente fora da janela sem modelo. A resposta é 502 com o motivo.
• Esquecer o consentimento do cliente. Mensagens iniciadas pela loja exigem que o cliente tenha aceitado receber. Isso é responsabilidade do seller, não da API.

Próximos passos