Prompts para IA

Eres un desarrollador senior experto en integraciones de APIs REST. Vas a integrar la API de WhatsBoost para envio de mensajes SMS, WhatsApp, verificacion OTP y codigos USSD.

=== INFORMACION DE LA API ===
Base URL: //whatsboost.netapi/
Metodo: POST (envio) | GET (consulta)
Auth: Parametro "secret" con tu API Key en cada request
Content-Type: application/x-www-form-urlencoded
Respuesta: JSON con campos: status (int), message (string|false), data (mixed|false)

=== ENDPOINTS DE ENVIO (POST) ===

1. ENVIAR SMS: POST /api/send/sms
Parametros: secret (requerido), phone (requerido, formato E.164 ej: +34612345678), message (requerido), mode (requerido: "devices" o "credits"), device (requerido si mode=devices, UUID del dispositivo), gateway (requerido si mode=credits, ID de pasarela), sim (opcional: 1 o 2, default 1)
Respuesta exitosa: status=200, data=ID del mensaje

2. ENVIAR WHATSAPP: POST /api/send/whatsapp
Parametros: secret (requerido), phone (requerido), message (requerido para texto), account (requerido, ID numerico de cuenta WhatsApp), type (opcional: text|media|document, default text), media_url (requerido si type=media o document), media_type (requerido si type=media: image|video|audio), document_name (opcional, nombre del archivo), priority (opcional: 0=cola normal, 1=prioridad inmediata)
Respuesta exitosa: status=200, data=ID del mensaje

3. ENVIAR OTP: POST /api/send/otp
Parametros: secret (requerido), phone (requerido), expires (opcional, minutos de validez, default 5)
Respuesta exitosa: status=200, data=OTP generado y timestamp de expiracion

4. VERIFICAR OTP: POST /api/send/otp (con otp)
Parametros: secret (requerido), phone (requerido), otp (requerido, codigo de 6 digitos)
Respuesta exitosa: status=200, message="OTP is valid!"
Error: status=403, message="OTP is invalid or expired!"

5. ENVIAR USSD: POST /api/send/ussd
Parametros: secret (requerido), device (requerido, UUID), code (requerido, codigo USSD ej: *123#), sim (opcional: 1 o 2)
Respuesta exitosa: status=200

=== ENDPOINTS DE CONSULTA (GET) ===
Todos usan: ?secret=API_KEY&page=1&limit=10
/api/get/credits, /api/get/subscription, /api/get/devices, /api/get/wa.accounts
/api/get/sms.sent, /api/get/sms.received, /api/get/wa.sent, /api/get/wa.received
/api/get/rates, /api/get/wa.servers, /api/get/contacts, /api/get/ussd

=== CODIGOS DE ERROR ===
200: Exito | 400: Parametros invalidos (no reintentar) | 401: API Key invalida | 403: Sin permisos o limite alcanzado | 404: Recurso no encontrado | 500: Error servidor (reintentar con backoff) | 503: Capacidad maxima (reintentar con backoff)

=== ESTADOS DE MENSAJE ===
1=Pendiente, 2=En proceso, 3=Enviado, 4=Fallido

=== BUENAS PRACTICAS ===
- Nunca exponer la API Key en frontend. Usar siempre server-side.
- Implementar reintentos con backoff exponencial para errores 500/503.
- Validar numeros en formato E.164 antes de enviar.
- Para WhatsApp con media: la URL debe ser publica y accesible.
- Implementar webhooks para recibir eventos en tiempo real.

MI STACK: [INDICA TU LENGUAJE/FRAMEWORK]
MI API KEY: [TU_API_KEY]
LO QUE NECESITO: [DESCRIBE TU CASO DE USO]

Necesito integrar el envio de SMS a traves de la API de WhatsBoost.

API ENDPOINT: POST //whatsboost.netapi/send/sms
Content-Type: application/x-www-form-urlencoded
Respuesta: JSON con status (int), message (string|false), data (mixed|false)

PARAMETROS:
- secret (string, requerido): API Key de autenticacion
- phone (string, requerido): Numero en formato E.164 (ej: +34612345678)
- message (string, requerido): Contenido del SMS. Soporta spintax: {Hola|Buenos dias}
- mode (string, requerido): "devices" (via Android) o "credits" (via pasarela)
- device (string, requerido si mode=devices): UUID del dispositivo Android
- gateway (int|string, requerido si mode=credits): ID de la pasarela SMS
- sim (int, opcional): Ranura SIM 1 o 2 (default 1, solo mode=devices)

DOS MODOS DE ENVIO:
1. mode=devices: El SMS se envia desde un movil Android vinculado. Necesitas el UUID del dispositivo. Sin coste adicional (usa la tarifa del operador).
2. mode=credits: El SMS se envia por pasarela profesional. Necesitas el ID de la pasarela. Descuenta creditos del saldo.

CONSULTAR DISPOSITIVOS: GET //whatsboost.netapi/get/devices?secret=API_KEY
CONSULTAR PASARELAS: GET //whatsboost.netapi/get/rates?secret=API_KEY

ERRORES COMUNES:
- 400 "Invalid phone number!" → Verificar formato E.164
- 400 "Message is too short!" → Mensaje vacio
- 403 "Maximum allowed number of sent messages has been reached!" → Limite diario alcanzado
- 403 "Not enough credits to send this message!" → Recargar creditos
- 404 "Device doesn't exist!" → Verificar UUID del dispositivo

RESPUESTA EXITOSA: status=200, message="Message has been sent!", data=ID_del_mensaje
ESTADOS: 1=Pendiente, 2=En proceso, 3=Enviado, 4=Fallido

Mi stack es: [TU STACK]
Modo de envio preferido: [devices o credits]
Necesito: [DESCRIBE: envio individual, masivo, con plantilla, etc.]

Necesito integrar el envio de mensajes WhatsApp a traves de la API de WhatsBoost.

API ENDPOINT: POST //whatsboost.netapi/send/whatsapp
Content-Type: application/x-www-form-urlencoded
Respuesta: JSON con status (int), message (string|false), data (mixed|false)

PARAMETROS:
- secret (string, requerido): API Key
- phone (string, requerido): Numero destino formato E.164 (ej: +34612345678)
- message (string, requerido para texto): Contenido del mensaje
- account (int, requerido): ID numerico de la cuenta WhatsApp remitente
- type (string, opcional): "text" (default), "media" o "document"
- media_url (string, requerido si type=media o document): URL publica del archivo
- media_type (string, requerido si type=media): "image", "video" o "audio"
- document_name (string, opcional): Nombre del archivo para documentos
- priority (int, opcional): 0=cola normal (default), 1=prioridad inmediata

TIPOS DE MEDIA SOPORTADOS:
- image: jpg, jpeg, png, gif, webp (max 16MB)
- video: mp4, 3gp (max 16MB)
- audio: mp3, ogg, amr (max 16MB)
- document: pdf, doc, docx, xls, xlsx, ppt, pptx (max 100MB)

CONSULTAR CUENTAS: GET //whatsboost.netapi/get/wa.accounts?secret=API_KEY
(Usa el campo "id" de la respuesta como parametro "account")

EJEMPLOS DE PAYLOADS:
Texto: secret=KEY&phone=+34612345678&message=Hola&account=1&type=text
Imagen: secret=KEY&phone=+34612345678&message=Mira esta foto&account=1&type=media&media_url=https://ejemplo.com/foto.jpg&media_type=image
Documento: secret=KEY&phone=+34612345678&message=Tu factura&account=1&type=document&media_url=https://ejemplo.com/factura.pdf&document_name=Factura_2026.pdf

ERRORES COMUNES:
- 400 "Invalid media URL!" → URL no accesible o no publica
- 400 "Unsupported media file type!" → Extension no soportada
- 404 "WhatsApp account doesn't exist!" → ID de cuenta incorrecto
- 404 "WhatsApp phone number does not exist!" → Destinatario no tiene WhatsApp
- 500 "WhatsApp account is disconnected!" → Reconectar escaneando QR

Mi stack es: [TU STACK]
Mi cuenta WhatsApp ID: [TU ACCOUNT ID]
Necesito: [DESCRIBE: texto, imagenes, documentos, masivo, etc.]

Necesito implementar un flujo completo de verificacion OTP (One-Time Password) usando la API de WhatsBoost.

API BASE URL: //whatsboost.netapi/

=== PASO 1: GENERAR Y ENVIAR OTP ===
Endpoint: POST /api/send/otp
Parametros:
- secret (string, requerido): API Key
- phone (string, requerido): Numero del usuario en formato E.164
- expires (int, opcional): Minutos de validez del codigo (default: 5)

Respuesta exitosa:
status=200, message="OTP has been sent!", data contiene el OTP generado y timestamp de expiracion.
WhatsBoost envia automaticamente el codigo al numero indicado por SMS.

=== PASO 2: VERIFICAR OTP ===
Endpoint: POST /api/send/otp
Parametros:
- secret (string, requerido): API Key
- phone (string, requerido): Mismo numero usado en el paso 1
- otp (string, requerido): Codigo de 6 digitos introducido por el usuario

Respuestas:
- Exito: status=200, message="OTP is valid!"
- Error: status=403, message="OTP is invalid or expired!"

=== FLUJO COMPLETO ===
1. Usuario introduce su telefono en tu formulario
2. Tu backend llama POST /api/send/otp con el telefono
3. WhatsBoost envia un SMS con el codigo de 6 digitos
4. Usuario recibe el SMS e introduce el codigo en tu formulario
5. Tu backend llama POST /api/send/otp con phone + otp
6. Si status=200, el usuario esta verificado. Si status=403, codigo incorrecto o expirado.

=== BUENAS PRACTICAS ===
- Limita los reintentos de verificacion (max 3-5 intentos por codigo)
- Implementa rate limiting para evitar abuso (max 1 OTP cada 60 segundos por numero)
- No guardes el OTP en tu base de datos, solo verifica contra la API
- Ofrece opcion de "Reenviar codigo" con cooldown de 60 segundos
- Muestra un contador regresivo con el tiempo restante de validez

Mi stack es: [TU STACK]
Contexto: [registro de usuario, recuperar contrasena, confirmar pedido, etc.]

Necesito construir un chatbot de WhatsApp usando la API de WhatsBoost. La arquitectura es: webhook recibe mensaje entrante, mi servidor procesa y responde via API.

=== ARQUITECTURA ===

1. RECIBIR MENSAJES (Webhook):
WhatsBoost envia POST a mi URL con: secret (string SHA1), type="whatsapp", data (JSON string).
Data contiene: id, wid, phone, message, attachment (url o null), timestamp.
Debo verificar el secret y responder HTTP 200 inmediatamente.

2. RESPONDER MENSAJES (API):
Endpoint: POST //whatsboost.netapi/send/whatsapp
Parametros: secret (API Key), phone (numero del usuario), message (respuesta), account (ID cuenta WhatsApp)
Para enviar media: anadir type=media, media_url, media_type (image|video|audio)
Para enviar documentos: type=document, media_url, document_name

=== GESTION DE ESTADO ===
Necesito mantener el estado de la conversacion por usuario. Estructura sugerida:
- user_phone: numero del usuario
- current_state: estado actual en el flujo (ej: "menu_principal", "esperando_nombre", "confirmando_pedido")
- context: datos temporales de la conversacion (nombre, seleccion, carrito, etc.)
- last_interaction: timestamp de ultima actividad
- Expirar sesion tras 30 minutos de inactividad

=== FLUJO DEL CHATBOT ===
1. Webhook recibe mensaje entrante
2. Verificar secret del webhook
3. Extraer phone y message del payload
4. Buscar estado del usuario en base de datos
5. Si no existe estado, crear uno nuevo con state="bienvenida"
6. Procesar el mensaje segun el estado actual
7. Actualizar el estado del usuario
8. Enviar respuesta via POST /api/send/whatsapp
9. Responder 200 al webhook

=== PATRON DE PROCESAMIENTO ===
Cada estado tiene:
- Mensaje que se muestra al entrar
- Opciones validas (texto o numeros)
- Siguiente estado segun la respuesta
- Accion a ejecutar (guardar dato, consultar DB, llamar API externa)

=== MANEJO DE ERRORES ===
- Si el mensaje no coincide con ninguna opcion: repetir el menu actual
- Si la API falla al enviar: encolar y reintentar
- Si el webhook falla: logear el error (WhatsBoost no reintenta)
- Mensaje por defecto: "No entendi tu mensaje. Escribe MENU para volver al inicio."

Mi stack es: [TU STACK]
Base de datos: [MySQL, MongoDB, Redis, etc.]
Mi webhook URL: [TU URL]
Mi cuenta WhatsApp ID: [TU ACCOUNT ID]
Flujo del chatbot: [DESCRIBE LOS MENUS Y OPCIONES QUE QUIERES]

Necesito implementar un sistema de notificaciones automaticas por WhatsApp para mi tienda online usando la API de WhatsBoost.

API ENDPOINT: POST //whatsboost.netapi/send/whatsapp
Parametros base: secret (API Key), phone (numero cliente), message (texto), account (ID cuenta WhatsApp)
Para documentos (facturas): type=document, media_url (URL publica del PDF), document_name="Factura_XXXX.pdf"

=== NOTIFICACIONES A IMPLEMENTAR ===

1. CONFIRMACION DE PEDIDO (inmediata tras pago):
Mensaje: Nombre del cliente, numero de pedido, resumen de productos, total, metodo de pago, enlace de seguimiento.
Adjunto: Factura en PDF si esta disponible.

2. PEDIDO ENVIADO (cuando se genera tracking):
Mensaje: Numero de pedido, transportista, numero de seguimiento, enlace de tracking, fecha estimada de entrega.

3. PEDIDO ENTREGADO (cuando el tracking marca entrega):
Mensaje: Confirmacion de entrega, enlace para reportar incidencia, enlace para dejar resena.

4. SOLICITUD DE RESENA (48h despues de entrega):
Mensaje: Invitacion amigable a dejar una valoracion, enlace directo al formulario de resena, incentivo (descuento para proxima compra).

5. PROGRAMA DE FIDELIZACION (7 dias despues si no ha comprado):
Mensaje: Agradecimiento, codigo de descuento personalizado, productos relacionados.

6. CARRITO ABANDONADO (1h despues del abandono):
Mensaje: Recordatorio del carrito, resumen de productos, enlace directo al checkout.

=== REQUISITOS TECNICOS ===
- Cada notificacion debe tener un sistema de plantillas con variables: {nombre}, {pedido}, {total}, etc.
- Implementar cola de mensajes para no exceder limites de la API.
- Respetar horarios: no enviar entre 22:00 y 09:00 hora local del cliente.
- Gestionar opt-out: si el cliente responde "BAJA", marcar como unsubscribed.
- Log de cada envio: mensaje, timestamp, estado de entrega.

Mi stack es: [TU STACK]
Mi plataforma e-commerce: [WooCommerce, Shopify, PrestaShop, custom, etc.]
Mi cuenta WhatsApp ID: [TU ACCOUNT ID]
Zona horaria: [TU TIMEZONE]

Necesito automatizar las comunicaciones por WhatsApp de mi negocio turistico, integrando con el sistema de reservas TuriTop y la API de WhatsBoost.

API WHATSBOOST:
- Enviar WhatsApp: POST //whatsboost.netapi/send/whatsapp
  Parametros: secret (API Key), phone, message, account (ID cuenta WhatsApp)
  Para documentos: type=document, media_url, document_name
- Recibir mensajes: Webhook POST con secret, type="whatsapp", data (JSON con phone, message, attachment)

=== FLUJO COMPLETO DE AUTOMATIZACION ===

1. CONFIRMACION DE RESERVA (inmediata tras reserva):
Disparador: Webhook de TuriTop notifica nueva reserva.
Mensaje: Nombre del cliente, actividad reservada, fecha y hora, numero de personas, punto de encuentro con Google Maps, codigo de reserva.
Incluir: "Responde SI para confirmar asistencia."

2. SOLICITUD DE CONSENTIMIENTO (inmediata):
Mensaje: Enlace a formulario de consentimiento/condiciones de la actividad.
Si la actividad es de aventura: incluir consentimiento de riesgos.
Incluir: "Firma digital requerida antes de la actividad."

3. CONFIRMACION DE PAGO (tras pago):
Disparador: Webhook de TuriTop o pasarela de pago.
Mensaje: Confirmacion del pago, importe, metodo, numero de factura.
Adjunto: Factura/recibo en PDF.

4. RECORDATORIO PRE-ACTIVIDAD (24h antes):
Disparador: Cron job que busca reservas para manana.
Mensaje: Recordatorio de la actividad, hora, punto de encuentro, que llevar (ropa, proteccion solar, etc.), condiciones meteorologicas, telefono de emergencia.
Incluir: "Responde CANCELAR si no puedes asistir."

5. RECORDATORIO DIA DE LA ACTIVIDAD (2h antes):
Mensaje breve: "Te esperamos en [lugar] a las [hora]. Buen viaje!"

6. ENCUESTA DE SATISFACCION (24h despues):
Mensaje: Agradecimiento, enlace a encuesta de satisfaccion (Google Forms, Typeform, etc.), enlace para dejar resena en Google/TripAdvisor.
Incluir: "Valoranos del 1 al 5 respondiendo a este mensaje."

7. FIDELIZACION (7 dias despues):
Mensaje: Agradecimiento final, codigo de descuento para proxima reserva (10%), enlace al catalogo de actividades.
Incluir: "Comparte este codigo con amigos y ambos obtienen descuento."

=== MANEJO DE RESPUESTAS (Chatbot) ===
- "SI" / "CONFIRMO" → Marcar asistencia confirmada, responder "Confirmado!"
- "CANCELAR" → Iniciar proceso de cancelacion, responder con politica de cancelacion
- "1"-"5" → Guardar valoracion en base de datos, responder agradecimiento
- "AYUDA" → Enviar telefono y email de contacto
- Cualquier otro → "Gracias por tu mensaje. Te responderemos pronto."

=== REQUISITOS ===
- Cola de mensajes con control de horario (no enviar de noche).
- Multilingue: detectar idioma del cliente (es, en, fr, de) y enviar en su idioma.
- Base de datos para tracking de cada comunicacion enviada.
- Dashboard para ver estadisticas de apertura y respuesta.

Mi stack es: [TU STACK]
Mi cuenta WhatsApp ID: [TU ACCOUNT ID]
Integracion TuriTop: [webhook URL o API key de TuriTop]
Idiomas: [es, en, fr, de...]

Necesito implementar un manejo de errores robusto y profesional para la API de WhatsBoost.

API BASE URL: //whatsboost.netapi/
Formato de respuesta: JSON con status (int), message (string|false), data (mixed|false)

=== CATALOGO COMPLETO DE ERRORES ===

HTTP 400 (Bad Request) - NO REINTENTAR, corregir parametros:
- "Invalid Parameters!" → Faltan parametros o formato incorrecto
- "Invalid phone number!" → Formato E.164 invalido
- "Message is too short!" / "Message is too long!" → Longitud fuera de rango
- "Invalid media URL!" → URL no accesible
- "Invalid media type!" / "Unsupported media file type!" → Tipo no soportado
- "QR string is too short to be valid!" → QR incompleto
- "We detected inappropriate content in your message!" → Contenido bloqueado
- "We detected inappropriate content in your media!" → Media bloqueado

HTTP 401 (Unauthorized) - NO REINTENTAR, verificar credenciales:
- "Invalid API secret supplied!" → API Key incorrecta o desactivada

HTTP 403 (Forbidden) - NO REINTENTAR (excepto limites diarios):
- "This API key doesn't have permission to use this endpoint!" → Activar permiso
- "Subscription has no permission to use SMS/WhatsApp services!" → Cambiar plan
- "Account is not subscribed to any premium package!" → Contratar plan
- "Maximum allowed number of sent messages has been reached!" → Limite diario, reintentar tras medianoche
- "You have reached the maximum number of allowed chats!" → Esperar
- "Not enough credits to send this message!" → Recargar creditos
- "Selected WhatsApp server is at full capacity" → Probar otro servidor
- "Device is not available!" → Dispositivo offline
- "OTP is invalid or expired!" → Solicitar nuevo OTP
- "Maximum number of USSD requests has been reached!" → Limite diario

HTTP 404 (Not Found) - NO REINTENTAR, verificar IDs:
- "Device doesn't exist!" → Consultar GET /api/get/devices
- "WhatsApp account doesn't exist!" → Consultar GET /api/get/wa.accounts
- "Specified gateway doesn't exist!" → Consultar GET /api/get/rates
- "WhatsApp phone number does not exist!" → Numero sin WhatsApp

HTTP 500 (Server Error) - REINTENTAR con backoff:
- "System configuration error!" → Error interno
- "Unable to connect to WhatsApp servers!" → Problema de red temporal
- "WhatsApp account is disconnected!" → Reconectar QR
- "Failed sending WhatsApp chat!" → Error de envio
- "Gateway was unable to send your message!" → Probar otra pasarela

HTTP 503 - REINTENTAR con backoff:
- "All WhatsApp servers are at full capacity" → Alta demanda

=== PATRONES A IMPLEMENTAR ===

1. WRAPPER DE RESPUESTA: Funcion que parsea la respuesta y lanza excepciones tipadas.
2. RETRY CON BACKOFF: Para 500/503, reintentar 3 veces con delays de 1s, 2s, 4s.
3. CIRCUIT BREAKER: Tras 5 errores 500 consecutivos, pausar 5 minutos.
4. COLA DE MENSAJES: Para errores 403 de limite diario, encolar y reintentar tras medianoche.
5. LOGGING: Cada error debe logearse con timestamp, endpoint, parametros (sin secret), y respuesta completa.
6. ALERTAS: Notificar por email/Slack cuando: circuit breaker se activa, creditos bajos, cuenta desconectada.
7. FALLBACK: Si WhatsApp falla, intentar enviar por SMS como alternativa.

Mi stack es: [TU STACK]
Sistema de colas: [Redis, RabbitMQ, database, etc.]
Sistema de logging: [Monolog, Winston, etc.]