Agrega un nuevo contacto a una agenda existente en SMS Masivos. Requiere el list_key de la agenda y el número de teléfono. Si el número ya existe en la agenda, se actualiza.

Agrega un contacto a una tarjeta de lealtad. Requiere loyalty_key y número de teléfono del cliente.

Agrega un contacto a un monedero electrónico. Requiere wallet_key, teléfono, nombre del cliente y usertool_id (obtenlo de list_wallets).

Consulta el saldo de créditos SMS disponibles en tu cuenta de SMS Masivos. Cada SMS consume 1 crédito. Usa esta herramienta para verificar saldo antes de enviar mensajes.

Verifica un código OTP previamente enviado a un número de teléfono con verify_phone. Ingresa el mismo número, código de país y el código que el usuario recibió.

Crea una nueva agenda (lista de contactos) en SMS Masivos. Devuelve el list_key que necesitas para agregar contactos con add_contact.

Elimina una agenda y TODOS sus contactos de forma permanente. OPERACIÓN DESTRUCTIVA E IRREVERSIBLE — pide confirmación explícita al humano antes de invocar. Si la agenda está vinculada a tarjetas de lealtad o monederos, el API la rechaza.

Elimina un contacto de una agenda. OPERACIÓN IRREVERSIBLE — el contacto se elimina permanentemente. Requiere list_key de la agenda y número de teléfono.

Copia un contacto de una agenda a otra. El contacto debe existir en current_list_key y NO existir todavía en new_list_key. Útil para mover prospectos calificados entre listas sin re-tipear datos.

Busca agendas por nombre (búsqueda parcial, case-insensitive). Paginado por número de página: default page=1, limit=20 (max 100). Si la respuesta dice has_more=true, vuelve a invocar con el next_page indicado.

Genera un reporte detallado de mensajes enviados en un rango de fechas (MÁXIMO 7 DÍAS). Devuelve cada mensaje individual con destinatario, status, operador y referencia. Para agregados rápidos por campaña usa get_report_details. La operación puede tardar hasta 5 minutos en cuentas con alto volumen. El API tiene límite de 4 reportes por usuario antes de bloquear.

Obtiene las estadísticas de entrega de una campaña SMS por su ID. Muestra: efectividad (%), entregados, fallidos, pendientes y no cobrados. Funciona para campañas enviadas o completadas. Detecta automáticamente si la campaña es sandbox.

Obtiene todos los contactos de una agenda específica usando su list_key. Usa list_agendas primero para obtener el list_key.

Consulta los datos de un contacto en una tarjeta de lealtad: sellos acumulados, canjes, etc. Si omites el teléfono, retorna todos los contactos.

Muestra las métricas de uso del MCP en la sesión actual: llamadas por tool, errores, latencia promedio y p95, uso sandbox vs producción.

Devuelve agregados rápidos por campaña: total enviados, entregados, fallidos, pendientes, no cobrados y % de efectividad. Mucho más rápido que generate_report cuando solo necesitas KPIs. Requiere campaign_id (obténlo de list_campaigns o send_sms).

Consulta el saldo de un contacto en un monedero electrónico. Si omites el teléfono, retorna todos los contactos con sus saldos.

Lista todas las agendas (listas de contactos) de tu cuenta en SMS Masivos. Cada agenda tiene un list_key único que necesitas para obtener contactos o agregar nuevos.

Lista las campañas SMS de tu cuenta, ordenadas de más reciente a más antigua. Puedes filtrar por rango de fechas. Usa el ID de campaña con get_campaign_stats para ver estadísticas de entrega.

Lista todas las tarjetas de lealtad de tu cuenta. Cada tarjeta tiene un loyalty_key que necesitas para gestionar contactos y registrar ventas.

Lista todos los monederos electrónicos de tu cuenta. Cada monedero tiene un wallet_key y usertool_id que necesitas para gestionar contactos y saldos.

Gestiona el webhook configurado para tu cuenta (uno por usuario). Acciones: 'list' (ver), 'add' (registrar o reemplazar), 'toggle' (cambiar estado), 'delete' (eliminar — DESTRUCTIVO, pide confirmación al humano antes). El webhook recibe eventos de entrega de SMS. URL debe ser https; rechaza IPs privadas y localhost.

Cambia el nombre de una agenda existente. Requiere el list_key (obténlo con list_agendas).

Reenvía un código OTP a un número que ya tenía una verificación activa con verify_phone. Útil cuando el usuario reporta que no le llegó el SMS. Por default reenvía el mismo código; pasa reset_code='1' para regenerar uno nuevo.

Resetea el estado de una verificación de teléfono — limpia los intentos fallidos y opcionalmente genera un código nuevo. Úsalo cuando el usuario excedió los intentos o el código expiró y quieres permitirle reintentar sin crear una verificación nueva con verify_phone.

Envía una solicitud de pago a un cliente vía SMS usando un template configurado en la cuenta. El template debe existir y estar activo en la sección de Solicitudes de Pago. El cliente recibe un SMS con link corto a la página de pago.

Envía uno o varios mensajes SMS a través de SMS Masivos. Requiere números de teléfono (separados por coma, máximo 500), texto del mensaje y código de país. Usa sandbox='1' para pruebas sin envío real. El código de país por defecto es 52 (México).

Actualiza los datos de un contacto existente en una agenda. Identifica al contacto por list_key + number. Si el contacto no existe en esa agenda, sugiere usar add_contact en su lugar.

Agrega o resta saldo en el monedero de un contacto. transaction_type '1' = agregar, '2' = restar. Requiere wallet_key, teléfono, monto y usertool_id.

Inicia una verificación de número de teléfono enviando un código OTP por SMS. Opcionalmente puede enviarse por llamada de voz o WhatsApp. Después usa check_verification para verificar el código que ingrese el usuario.