¿Puedo crear mis Ofertas Inteligentes por API?

Objetivo: Crear, leer, editar y borrar ofertas de Shopify por API con su producto, descuento y condiciones.

Nivel: Avanzado · Duración: 3 min · Antes de esta lección: «¿Cómo creo mi primera oferta y la escucho antes que mi cliente?», «¿Qué permisos le doy a cada llave de API y cómo pruebo sin gastar saldo?»

Dónde, en Talkyria: app.talkyria.com/ofertas/shopify

Gancho

Tienes 40 productos y quieres una oferta para cada uno. Hacerlo a mano toma una tarde; con la API lo hace tu sistema en un minuto.

Lo que vas a lograr

Vas a crear una oferta de Shopify por API con su producto, su descuento y sus condiciones, y a leerla, editarla o borrarla.

Pasos en pantalla

1. Listar: GET https://api.talkyria.com/api/v1/offers. Con integration shopify ves solo las de Shopify. Cada oferta trae su configuración y sus resultados: veces mostrada, aceptada e ingresos.
2. Crear: POST /offers con integration shopify. Obligatorios: name, offerProductId y offerProductTitle, es decir, el producto que el agente va a ofrecer.
3. El tipo va en el campo type: upsell, quantity o bundle. Si no lo envías, se crea como upsell.
4. El descuento: discountType percentage o fixed, con offerDiscountPercent u offerDiscountFixed, y offerProductPrice. Talkyria calcula el precio final.
5. Las condiciones, las mismas del panel: triggerType y triggerProductIds para decidir con qué productos aparece, minOrderAmount, maxOrderAmount, maxOrderItems, maxDailyAcceptances, countries y priority.
6. Para cantidad, quantityMin y quantityMax o escalones; para un combo, los productos del combo. Una oferta por cantidad nunca se excluye por tener el producto en el carrito.
7. Editar: PATCH /offers/{id} con solo los campos que cambian; isActive false la apaga. Borrar: DELETE /offers/{id}.
8. Abre «Ofertas» en el panel: tu oferta aparece en la lista y puedes probarla en una llamada de prueba, como en la lección «¿Cómo creo mi primera oferta y la escucho antes que mi cliente?».

Error común y cómo resolverlo

Enviar el tipo en un campo llamado offerType en una oferta de Shopify. En las de Shopify el tipo se lee del campo type: si usas otro nombre, la oferta se crea como upsell. Revisa el tipo en la respuesta antes de seguir.

¿Y ahora qué?

Ahora gestiona tus agentes y su conversación por API. Siguiente lección: «¿Cómo creo y edito agentes y su conversación por API?».