Saltar al contenido

Herramientas · Ventas y planes

Herramientas MCP para vender: listar planes, productos y cupones, crear opciones de cobro y planes con adicionales en borrador, publicar y retirar de la venta, cambiar precios, crear, editar y eliminar cupones y ofertas de downsell, eliminar productos y planes y reordenar los planes, con confirmación en lo que toca al dinero.

Lo que vende la comunidad: planes con las opciones de cobro y los adicionales, productos sueltos, cupones. Todo nace en borrador y solo sale a la venta cuando tú lo pides; cambiar un precio, crear o editar un cupón, crear o editar una oferta de última oportunidad y eliminar piden tu sí, con un resumen de los importes. Cambiar un plan (update_plan) se ejecuta en la primera llamada.

Borrador antes de la aprobación

Puedes montarlo todo antes de que se apruebe la información empresarial: los productos, las opciones, los planes, los adicionales, los cupones y las ofertas de downsell nacen en borrador y se pueden editar a voluntad. Lo que espera la aprobación es publicar y vender:

  • publish_product en una comunidad sin aprobación se rechaza con el mensaje de Memberfy: "Para publicar y empezar a vender, la comunidad necesita tener la información empresarial aprobada. Mientras tanto, puedes crear y configurar todo como borrador: complétala en Configuración › Información Empresarial y envíala a revisión."
  • En las compuestas (create_course, create_event y create_plan con publicar), el rechazo no deshace nada: el curso, el evento, la entrada, el plan y las opciones quedan en borrador, la respuesta trae el motivo en publish_blocked, y el siguiente paso sugerido es completar la información empresarial y después publicar con publish_product.
  • El precio de un borrador queda en la moneda del país de la información empresarial (en cualquier estado) o, si no la hay, en reales. Si la moneda aprobada es otra, la publicación se rechaza ("Este producto está en …, pero la moneda de la información empresarial aprobada es …"): ajusta antes la moneda y el precio.

Cada herramienta lleva un sello: Solo consulta no cambia nada, Modifica crea o cambia algo al momento, y Pide confirmación solo actúa después de tu sí a un resumen. Consulta Dinero y confirmación.

En resumen

HerramientaQué haceRol mínimoTipo
list_plansPlanes, opciones y adicionalesAdministrador o FinanzasSolo consulta
list_productsOpciones de cobro y productos, con precio y estadoAdministrador o FinanzasSolo consulta
list_couponsCupones con estado y usoAdministrador o FinanzasSolo consulta
create_productCrea un producto u opción de cobro, en borradorAdministradorModifica
create_planOpciones, plan y adicionales, de una vezAdministradorModifica
publish_productPone un producto a la ventaAdministradorModifica
unpublish_productRetira un producto de la ventaAdministradorModifica
update_priceCambia un precioAdministradorPide confirmación
create_couponCrea un cupónAdministradorPide confirmación
update_planCambia nombre, dirección, opciones y adicionales de un planAdministradorModifica
update_productCambia título, espacios, stock, cuotas, prueba y enlace directoAdministradorModifica
update_coupon_statusPausa o reactiva un cupónAdministradorPide confirmación
update_couponCambia el nombre, el descuento, la duración, los límites, la validez y los productos de un cupónAdministradorPide confirmación
delete_couponElimina un cupónAdministradorPide confirmación
get_coupon_usageQuién usó un cupónAdministrador o FinanzasSolo consulta
list_downsell_offersLas ofertas de última oportunidad de un plan, con conversiónAdministradorSolo consulta
create_downsell_offerCrea una oferta de última oportunidadAdministradorPide confirmación
update_downsell_offerCambia o pausa una oferta de última oportunidadAdministradorPide confirmación
delete_downsell_offerElimina una oferta de última oportunidadAdministradorPide confirmación
delete_productElimina un producto o una opción de cobroAdministradorPide confirmación
delete_planElimina un planAdministradorPide confirmación
reorder_plansPone los planes en un orden nuevo en la página de preciosAdministradorModifica
get_storefrontLo que muestra un espacio de TiendaAdministradorSolo consulta
update_storefrontElige los productos de una TiendaAdministradorModifica

list_plans

Solo consulta

Listar planes. Los planes de la comunidad, con las opciones de cobro y los adicionales de cada uno. Rol mínimo: administrador o Finanzas.

Parámetros: ninguno.

Devuelve: los planes (id, nombre, dirección), las opciones de cada uno (id, título, precio, intervalo, estado) y los adicionales.

Pídelo así: "¿Qué planes tenemos y cuánto cuesta cada opción?"

list_products

Solo consulta

Listar opciones de cobro y productos. Todos los productos: opciones de suscripción, sueltos, a plazos y adicionales. Rol mínimo: administrador o Finanzas.

Parámetros: ninguno.

Devuelve: cada producto con id, título, tipo, precio, intervalo, estado (borrador o publicado) y los espacios a los que da acceso. El id es el que piden create_plan (en add_on_ids), update_price, publish_product y create_coupon.

Pídelo así: "¿Qué productos están en borrador?"

list_coupons

Solo consulta

Listar cupones. Los cupones, con estado y uso. Rol mínimo: administrador o Finanzas.

ParámetroTipoObligatorioDescripción
statusACTIVE, INACTIVE, EXPIREDNoUn solo estado
searchtextoNoParte del código o del nombre
page, limitnúmeroNoPaginación

Devuelve: los cupones, con código, tipo, valor, duración, validez, límite y usos.

Pídelo así: "¿Qué cupones están activos y cuántas veces se ha usado cada uno?"

create_product

Modifica

Crear opción de cobro o producto. Crea un producto en borrador: una opción de suscripción, un producto suelto (entrada, curso) o uno a plazos. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
titletexto, de 3 a 255Sí
typeSUBSCRIPTION, ONE_TIME, INSTALLMENTSíOpción de suscripción, suelto o a plazos
pricenúmero, en la moneda de la comunidadSíEn la suscripción, el importe de cada ciclo; en el anual en cuotas, el importe del año
intervalMONTHLY, YEARLYNoSolo en SUBSCRIPTION: mensual o anual
max_installments1 a 12NoHasta cuántas cuotas con tarjeta (suelto, o anual)
commitment_months1 a 36NoDuración del contrato; solo en el mensual
trial_days0 a 365NoPrueba gratuita
descriptiontexto simple, hasta 5.000NoSin formato: las marcas de Markdown se eliminan
space_idslista de idsNoLos espacios a los que da acceso la compra
stocknúmeroNoCantidad a la venta (entradas). Vacío: sin límite
direct_linksí o noNoUn producto suelto vendible por enlace directo, fuera de la Tienda

Devuelve: el producto creado, en borrador, con el id.

Pídelo así: "Crea el producto Mentoría suelta, R$ 450, en hasta 3 cuotas, que da acceso al espacio Mentorías. Déjalo en borrador."

Notas: no se vende nada hasta publish_product, y crear no depende de que la información empresarial esté aprobada (consulta Borrador antes de la aprobación). Para un plan con varias opciones, create_plan lo hace todo de una vez. Las reglas de cada campo son las del panel: consulta Productos y Opciones de cobro.

create_plan

Modifica

Crear plan con opciones y adicionales. Opciones de cobro → plan con las opciones → adicionales vinculados. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
nametexto, hasta 120SíEl nombre del plan
descriptiontexto simpleNoSin formato: las marcas de Markdown se eliminan
slugtexto, hasta 60NoLa dirección del plan, para el enlace /pricing/<dirección>
optionslista, de 1 a 6SíLas opciones de cobro (ver más abajo)
add_on_idslista de idsNoProductos mensuales que ya existen y no son opción de ningún plan, de list_products
publishsí o noNoPublica todas las opciones. Por defecto: borrador
idempotency_keytexto, hasta 100No

Cada opción:

CampoTipoDescripción
titletexto, de 3 a 255Obligatorio. P. ej.: Mentoría · Mensual
pricenúmero, en la moneda de la comunidadObligatorio. En el anual, el importe del año
intervalMONTHLY, YEARLYPor defecto: MONTHLY
max_installments1 a 12En el anual, hasta cuántas cuotas con tarjeta
commitment_months1 a 36Contrato mínimo, en el mensual
trial_days0 a 365Prueba gratuita
descriptiontexto simpleSin formato: las marcas de Markdown se eliminan
space_idslista de idsLos espacios a los que da acceso la opción

Devuelve: el plan (id, nombre, dirección), las opciones (id, título, precio, intervalo, estado) y los adicionales vinculados.

Pídelo así: "Crea el plan Mentoría con mensual de R$ 390 con contrato de 6 meses y anual de R$ 3.900 en hasta 12 cuotas, los dos con acceso al espacio Mentoría, y vincula la Sesión individual como adicional."

Notas: si un paso falla, el plan se deshace el último, porque Memberfy no borra un plan que aún tiene opciones. Consulta Planes, Adicionales y Anual en cuotas.

publish_product

Modifica

Publicar producto (ponerlo a la venta). Pone a la venta un producto en borrador. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
product_ididSíDe list_products o de una creación

Devuelve: el producto, publicado.

Pídelo así: "Ya puedes publicar el producto Excel desde Cero."

Notas: publicar exige la información empresarial aprobada, y el producto en la moneda del país aprobado. Si no, Memberfy lo rechaza y el producto sigue en borrador, editable. Consulta Borrador antes de la aprobación.

unpublish_product

Modifica

Retirar producto de la venta. Retira un producto de la venta. Quien ya lo compró mantiene el acceso. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
product_ididSí

Devuelve: el producto, fuera de la venta.

Pídelo así: "Retira de la venta la entrada del encuentro de octubre."

update_price

Pide confirmación

Cambiar el precio de un producto. Cambia el precio de un producto o de una opción de cobro. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
product_ididSíDe list_products
new_pricenúmero, en realesSí

El resumen: el producto, el precio actual, el precio nuevo y el estado (borrador o publicado).

Pídelo así: "Sube el Growth Mensual de R$ 129 a R$ 149."

Notas: las suscripciones que ya existen siguen las reglas de Memberfy para los cambios de precio, las mismas que al editar desde el panel. Consulta Opciones de cobro.

create_coupon

Pide confirmación

Crear cupón. Crea un cupón de descuento, porcentual o de importe fijo, para todos los productos o solo para algunos. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
codetexto, de 2 a 50SíP. ej.: PRO20. Se guarda en mayúsculas
nametexto, hasta 120SíEl nombre interno
typePERCENTAGE, FIXEDSíPorcentual o importe fijo
valuenúmeroSí20 = 20 %, o el importe en reales
durationONCE, FOREVER, REPEATINGNoEn suscripciones: solo el 1.er cobro (por defecto), siempre, o durante unos meses
months1 a 36NoCon REPEATING
max_usesnúmeroNoVacío: sin límite
start_datefecha ISO 8601NoPor defecto: ahora
end_datefecha ISO 8601NoVacío: sin fin
product_idslista de idsNoSolo estos productos. Vacío: todos

El resumen: la acción, el código, el descuento (20% o R$ 50,00), la duración, el límite de usos, la validez y los productos.

Pídelo así: "Crea el cupón BLACK30, 30 % solo en el primer cobro, para los planes Growth, hasta 100 usos, válido hasta el 30/11."

Consulta Cupones.

update_plan

Modifica

Editar plan. Cambia el nombre, la descripción, la dirección, si está activo, las opciones de cobro y los adicionales de un plan. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
planid o enlace (/pricing/…)Sí
name, description, slugtextoNo
activesí o noNo
option_idslista de idsNoLa lista completa de opciones del plan
add_on_idslista de idsNoLa lista completa de adicionales

Pídelo así: "Quita la opción anual del plan Growth y deja solo la mensual."

Notas: cambia lo que se vende al momento, sin confirmación. El precio se cambia con update_price, que pide tu sí.

update_product

Modifica

Editar producto. Cambia título, descripciones, espacios que libera, stock, cuotas, prueba gratuita o enlace directo. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
productid o slugSí
title, description, short_descriptiontextoNo
space_idslista de idsNoLos espacios que libera la compra
stocknúmeroNo
max_installmentsnúmeroNo
trial_daysnúmeroNo
direct_linksí o noNo

Pídelo así: "Sube el stock de la entrada a 120."

Notas: el precio se cambia con update_price, que pide confirmación.

update_coupon_status

Pide confirmación

Pausar o reactivar cupón. Pausa o reactiva un cupón. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
couponid o códigoSí
statusACTIVE, INACTIVESíReactivar o pausar

Pídelo así: "Pausa el cupón BLACK30."

update_coupon

Pide confirmación

Editar cupón. Cambia un cupón que ya existe. Solo cambia lo que se envía; para pausarlo, update_coupon_status. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
couponid o códigoSí
name, descriptiontextoNo
valuenúmeroNoPorcentaje (20 = 20 %) o importe, según el tipo del cupón
durationONCE, FOREVER, REPEATINGNoUna vez, para siempre o durante algunos meses
months1 a 36NoCon REPEATING
max_uses, max_uses_per_personnúmeroNoLímites de uso
start_date, end_datefechaNoLa validez
product_idslista de idsNoLos productos en los que vale el cupón

Devuelve: en la primera llamada, el código y lo que cambia, y el código de confirmación.

Pídelo así: "Sube el BLACK30 al 40 % y amplíalo hasta el domingo."

Consulta Cupones.

delete_coupon

Pide confirmación

Eliminar cupón. Los descuentos ya concedidos siguen vigentes. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
couponid o códigoSí

Devuelve: en la primera llamada, el código y cuántas veces se ha usado, y el código de confirmación.

get_coupon_usage

Solo consulta

Ver el uso de un cupón. Quién lo usó, cuándo y cuánto descuento. Rol mínimo: administrador o Finanzas.

ParámetroTipoObligatorioDescripción
couponid o códigoSí
pagenúmeroNo

Pídelo así: "¿Quién ha usado el cupón BLACK30?"

list_downsell_offers

Solo consulta

Ofertas de downsell de un plan. Las ofertas de descuento en adicionales después de la compra de un plan, con cuántas veces se mostraron y convirtieron. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
planid o enlaceSí

Pídelo así: "¿Cuánto convierte la oferta de última oportunidad de la Extensión Coworking?"

create_downsell_offer

Pide confirmación

Crear oferta de downsell. Crea una oferta de descuento en un adicional, que se muestra después del pago del plan. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
planid o enlaceSí
add_on_ididSíEl adicional del plan
discount_percentnúmeroNo
timingIMMEDIATE, DELAYEDNoAl momento (por defecto) o después de un tiempo
delay_minutesnúmeroNoCon DELAYED
price_durationFOREVER, FIRST_CHARGE, CYCLESNoDescuento para siempre, solo en el primer cobro o durante algunos ciclos
cyclesnúmeroNoCon CYCLES
ttl_minutesnúmeroNoCuánto tiempo vale la oferta

Pídelo así: "Ofrece un 30% en la Extensión Coworking a quien se suscriba a Growth sin ella, en los 3 primeros cobros."

Consulta Downsell.

update_downsell_offer

Pide confirmación

Editar oferta de downsell. Cambia una oferta de última oportunidad de un plan, o la pausa. Solo cambia lo que se envía. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
planid o enlaceSí
offer_ididSíDe list_downsell_offers
discount_percent, timing, delay_minutes, price_duration, cycles, ttl_minutesNoLos mismos de create_downsell_offer
activesí o noNoCon no, pausa la oferta

Pídelo así: "Pausa la oferta de la Extensión Coworking hasta final de mes."

delete_downsell_offer

Pide confirmación

Eliminar oferta de downsell. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
planid o enlaceSí
offer_ididSíDe list_downsell_offers

delete_product

Pide confirmación

Eliminar producto. Elimina un producto o una opción de cobro. Quien lo compró conserva el acceso. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
productid o slugSíDe list_products

Devuelve: en la primera llamada, el título, el precio y el estado, y el código de confirmación.

Notas: si solo quieres dejar de vender, mejor unpublish_product. Consulta Productos.

delete_plan

Pide confirmación

Eliminar plan. No se cancela a quien ya está suscrito. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
planid o enlace (/pricing/…)Sí

Devuelve: en la primera llamada, el nombre del plan y sus opciones, y el código de confirmación.

reorder_plans

Modifica

Reordenar planes. Pone los planes en un orden nuevo en la página de precios, del primero al último. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
plan_idslista de idsSíDe list_plans, en el orden nuevo

Pídelo así: "En la página de precios, pon Growth antes de Starter."

get_storefront

Solo consulta

Ver tienda. Lo que muestra un espacio de Tienda: todos los productos o solo los elegidos. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
spaceid o enlaceSíEl espacio de Tienda

update_storefront

Modifica

Elegir los productos de la tienda. Define lo que vende un espacio de Tienda. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
spaceid o enlaceSí
modeall, selectedSíTodos los productos publicados, o solo los elegidos
product_idslista de idsNoCon selected, de list_products

Pídelo así: "Deja en la tienda solo los cursos sueltos."

Consulta Tienda.

Relacionados