Maytapi
Maytapi/Documentación//catalog
/catalogPara números de WhatsApp BusinessAPI de catálogo de productos de WhatsApp
Gestiona el catálogo de productos de tu número de WhatsApp Business desde tu propio sistema. Añade productos y colecciones, envía un producto o el catálogo completo en un chat y recibe los pedidos de tus clientes sin salir de tu código.
- productos y colecciones
- mensajes de producto
- mensajes de catálogo
- pedidos en el webhook
Tu catálogo, gestionado por la API
Mantén el catálogo de WhatsApp sincronizado con tu tienda en lugar de editarlo a mano en la app.
-
catalog/addProduct
Añadir y editar productos
Crea productos con nombre, descripción, precio, imagen, enlace y retailer id; edítalos u ocúltalos después.
-
catalog/getProducts
Listar productos
Lee todos los productos del catálogo o uno concreto por id.
-
catalog/addCollection
Colecciones
Agrupa productos en colecciones y añade o quita productos de ellas.
-
type: product
Mensajes de producto
Envía la tarjeta de un producto al chat para que el cliente lo vea y lo pida.
-
type: catalog
Mensajes de catálogo
Comparte todo tu catálogo con título y descripción en un mensaje.
-
catalog/getOrders
Pedidos
Los pedidos hechos desde el catálogo llegan a tu webhook; los recientes también se pueden listar por API.
Sincroniza productos desde tu tienda
Envía los productos de tu e-commerce al catálogo de WhatsApp con una petición cada uno. Actualiza precios u oculta productos agotados de la misma forma.
- ✓Nombre, descripción, precio e imagen
- ✓Enlace del producto y tu propio retailer id
- ✓Ocultar un producto sin eliminarlo
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"
Envía un producto o el catálogo completo
Cuando un cliente pregunte, responde con la propia tarjeta del producto o el catálogo completo; ambos se abren de forma nativa en WhatsApp.
- ✓type: product con el id del producto
- ✓type: catalog con título y descripción opcionales
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": "3461xxxxx67@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": "3461xxxxx67@c.us",
"type": "catalog",
"message": "Check out our products!",
"title": "Our catalog",
"description": "New arrivals every week"
}'Recibe los pedidos en tu webhook
Cuando un cliente envía un pedido desde el catálogo, llega a tu webhook como cualquier otro mensaje. Guárdalo en tu base de datos: getOrders solo conserva los pedidos recibidos mientras la sesión está activa.
- ✓Los pedidos llegan en tiempo real
- ✓getOrders y getOrders/{orderId} para pedidos recientes
- ✓Guarda los pedidos en tu sistema para tener historial
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"
Quién usa la API de catálogo
-
Tiendas online
Mantén el catálogo de WhatsApp idéntico a tu tienda web, precios incluidos.
-
Equipos de ventas
Responde a preguntas sobre productos con la tarjeta del producto en lugar de un mensaje largo.
-
Agencias y SaaS
Gestiona los catálogos de muchos números de clientes desde una plataforma.
Preguntas frecuentes sobre el catálogo
Pregunta lo que quieras a nuestro equipo de soporte por WhatsApp. El tiempo medio de respuesta es inferior a 24 horas.
Centro de ayuda →¿Necesito una cuenta de WhatsApp Business?
Sí. El catálogo es una función de WhatsApp Business, así que el número conectado debe ser de WhatsApp Business.
¿Maytapi guarda los pedidos?
Los pedidos llegan a tu webhook en tiempo real. getOrders solo devuelve los recibidos mientras la sesión está activa, así que guárdalos en tu base de datos para tener historial permanente.
¿Puedo enviar un solo producto en un chat?
Sí. Envía un mensaje con type product y el id del producto; el cliente verá la tarjeta nativa del producto.
¿Puedo agrupar productos?
Sí. Crea colecciones y añade o quita productos por API.
Más funciones de la API de WhatsApp
Consigue tu clave y envía tu primer mensaje en diez minutos
Sin aprobación, sin plantillas, sin tarjeta. Todos los endpoints abiertos durante tres días.