Maytapi
Maytapi/Documentação//catalog
/catalogPara números do WhatsApp BusinessAPI de catálogo de produtos do WhatsApp
Gerencie o catálogo de produtos do seu número do WhatsApp Business a partir do seu próprio sistema. Adicione produtos e coleções, envie um produto ou o catálogo inteiro em um chat e receba os pedidos dos clientes sem sair do seu código.
- produtos e coleções
- mensagens de produto
- mensagens de catálogo
- pedidos no webhook
Seu catálogo, gerenciado pela API
Mantenha o catálogo do WhatsApp sincronizado com sua loja em vez de editá-lo à mão no app.
-
catalog/addProduct
Adicionar e editar produtos
Crie produtos com nome, descrição, preço, imagem, link e retailer id; depois edite ou oculte.
-
catalog/getProducts
Listar produtos
Leia todos os produtos do catálogo ou um produto específico pelo id.
-
catalog/addCollection
Coleções
Agrupe produtos em coleções e adicione ou remova produtos delas.
-
type: product
Mensagens de produto
Envie o cartão de um produto no chat para o cliente ver e pedir.
-
type: catalog
Mensagens de catálogo
Compartilhe o catálogo inteiro com título e descrição em uma mensagem.
-
catalog/getOrders
Pedidos
Os pedidos feitos pelo catálogo chegam ao seu webhook; os recentes também podem ser listados pela API.
Sincronize produtos da sua loja
Envie os produtos do seu e-commerce para o catálogo do WhatsApp com uma requisição para cada um. Atualize preços ou oculte itens esgotados do mesmo jeito.
- ✓Nome, descrição, preço e imagem
- ✓Link do produto e seu próprio retailer id
- ✓Ocultar um produto sem excluí-lo
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/addProduct" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Classic sneaker",
"description": "Canvas sneaker, sizes 38–45",
"price": "49.90",
"imageUrl": "https://example.com/sneaker.jpg",
"url": "https://example.com/sneaker",
"retailerId": "SKU-1042",
"isHidden": false
}'curl "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/getProducts" \ -H "x-maytapi-key: $TOKEN"
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/getCollections" \ -H "x-maytapi-key: $TOKEN"
Envie um produto ou o catálogo inteiro
Quando o cliente perguntar, responda com o próprio cartão do produto ou com o catálogo completo — ambos abrem de forma nativa no WhatsApp.
- ✓type: product com o id do produto
- ✓type: catalog com título e descrição opcionais
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "55119xxxxxx67@c.us",
"type": "product",
"productId": "3121315354601301"
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "55119xxxxxx67@c.us",
"type": "catalog",
"message": "Check out our products!",
"title": "Our catalog",
"description": "New arrivals every week"
}'Receba pedidos no seu webhook
Quando o cliente envia um pedido pelo catálogo, ele chega ao seu webhook como qualquer outra mensagem. Salve no seu banco de dados — o getOrders só guarda os pedidos recebidos enquanto a sessão está ativa.
- ✓Os pedidos chegam em tempo real
- ✓getOrders e getOrders/{orderId} para pedidos recentes
- ✓Guarde os pedidos no seu sistema para ter histórico
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/getOrders" \ -H "x-maytapi-key: $TOKEN"
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/getOrders/$ORDER_ID" \ -H "x-maytapi-key: $TOKEN"
Quem usa a API de catálogo
-
Lojas online
Mantenha o catálogo do WhatsApp idêntico à sua loja virtual, preços incluídos.
-
Equipes de vendas
Responda perguntas sobre produtos com o cartão do produto em vez de uma mensagem longa.
-
Agências e SaaS
Gerencie catálogos de vários números de clientes em uma única plataforma.
Perguntas frequentes sobre o catálogo
Pergunte o que quiser ao nosso suporte pelo WhatsApp. O tempo médio de resposta é inferior a 24 horas.
Central de ajuda →Preciso de uma conta do WhatsApp Business?
Sim. O catálogo é um recurso do WhatsApp Business, então o número conectado precisa ser do WhatsApp Business.
A Maytapi armazena os pedidos?
Os pedidos chegam ao seu webhook em tempo real. O getOrders só retorna os pedidos recebidos enquanto a sessão está ativa, então salve-os no seu banco de dados para ter histórico permanente.
Posso enviar um único produto em um chat?
Sim. Envie uma mensagem com type product e o id do produto; o cliente vê o cartão nativo do produto.
Posso agrupar produtos?
Sim. Crie coleções e adicione ou remova produtos pela API.
Mais recursos da API do WhatsApp
Pegue sua chave e envie a primeira mensagem em dez minutos
Sem aprovação, sem templates, sem cartão. Todos os endpoints liberados por três dias.