Auto-respuestas WhatsApp

Como funcionan las auto-respuestas

Cuando WhatsBoost recibe un mensaje entrante de WhatsApp, el sistema verifica si el contenido del mensaje coincide con alguna regla de auto-respuesta configurada por el usuario. Si encuentra una coincidencia, envia la respuesta automaticamente desde la cuenta vinculada especificada.

1. Mensaje entrante

Llega un mensaje a tu cuenta WhatsApp vinculada.

2. Evaluacion de reglas

El sistema compara el mensaje con tus keywords y reglas de matching.

3. Respuesta automatica

Si hay coincidencia, se envia la respuesta configurada al remitente.

Orden de evaluacion: Las auto-respuestas se evaluan en orden de prioridad. La primera regla que coincida se ejecuta. Si usas auto-respuesta con IA (match >= 6), la IA responde a todos los mensajes que no coincidan con ninguna keyword anterior.

Tipos de coincidencia (matching)

El parametro match determina como se compara el mensaje entrante con las palabras clave (keywords) configuradas en la auto-respuesta.

Valor	Tipo	Descripcion	Ejemplo
`1`	Coincidencia exacta	El mensaje debe ser exactamente igual a la keyword (sin distinguir mayusculas/minusculas).	Keyword: `hola` → Coincide con "hola", "Hola", "HOLA". No coincide con "hola que tal".
`2`	Contiene	El mensaje contiene la keyword en cualquier posicion.	Keyword: `precio` → Coincide con "cual es el precio", "precio del producto", "enviadme precios".
`3`	Empieza con	El mensaje comienza con la keyword.	Keyword: `reservar` → Coincide con "reservar mesa para 4". No coincide con "quiero reservar".
`4`	Termina con	El mensaje termina con la keyword.	Keyword: `gracias` → Coincide con "muchas gracias", "ok gracias". No coincide con "gracias, adios".
`5`	Expresion regular	El mensaje coincide con un patron regex personalizado.	Keyword: `/^(reserv\|book).*(mesa\|table)/i` → Coincide con "reservar mesa", "booking table".
`>= 6`	Inteligencia Artificial	No requiere keywords. La IA analiza el mensaje y genera una respuesta contextual.	El usuario escribe cualquier cosa y la IA responde de forma conversacional.

Keywords multiples: Puedes especificar varias palabras clave separadas por coma. El sistema buscara coincidencia con cualquiera de ellas. Ejemplo: hola,buenos dias,buenas.

Crear auto-respuesta

POST Dashboard > Herramientas > Auto-respuestas > Crear — caso add.autoreply con source=2

Crea una nueva regla de auto-respuesta para mensajes de WhatsApp entrantes.

Parametros

Parametro	Tipo	Estado	Descripcion
`name`	`string`	Obligatorio	Nombre descriptivo de la auto-respuesta (solo uso interno para identificarla).
`source`	`integer`	Obligatorio	Canal de origen. Para WhatsApp siempre es `2`.
`match`	`integer`	Obligatorio	Tipo de coincidencia: `1`=exacta, `2`=contiene, `3`=empieza con, `4`=termina con, `5`=regex, `>=6`=IA. Ver tipos de matching.
`keywords`	`string`	Condicional	Palabras clave separadas por coma. Requerido si `match` es 1-5. Se ignora para auto-respuesta con IA (`match >= 6`).
`message`	`string`	Condicional	Texto de la respuesta. Soporta spintax: `{Hola\|Buenos dias}`. Requerido si no es auto-respuesta con IA.
`account`	`string`	Obligatorio	ID de la cuenta WhatsApp vinculada que enviara la respuesta.
`message_type`	`string`	Opcional	Tipo de respuesta: `text`, `media` o `document`. Por defecto: `text`.
`priority`	`integer`	Opcional	Prioridad de envio: `1`=alta (inmediato), `2`=normal (cola). Por defecto: `2`.
`ai_key`	`integer`	Condicional	ID de la clave de IA configurada en el Dashboard. Requerido si `match >= 6`.
`ai_plugins`	`array`	Opcional	Array de IDs de plugins de IA para extender el comportamiento. Solo aplica cuando `match >= 6`.
`group_trigger`	`integer`	Opcional	`1`=responder en grupos de WhatsApp, `2`=solo chats privados. Por defecto: `2`.
`file`	`file`	Opcional	Archivo adjunto (imagen, video, audio o documento) via `multipart/form-data`. Solo para `message_type` de tipo `media` o `document`.

Auto-respuesta con Inteligencia Artificial

Cuando match >= 6, la auto-respuesta utiliza un modelo de IA para generar respuestas contextuales y conversacionales. No requiere keywords; la IA analiza cada mensaje entrante y responde de forma inteligente.

Modelos de IA soportados

OpenAI

GPT-4, GPT-4o, GPT-3.5 Turbo

Google

Gemini Pro, Gemini Flash

Anthropic

Claude Sonnet, Claude Haiku

Caracteristicas de la IA

Historial de conversacion: La IA recibe el historial de mensajes anteriores con el mismo contacto, permitiendo respuestas contextuales. La longitud del historial es configurable por clave de IA.
Adjuntos con vision: Si el mensaje entrante incluye una imagen, la IA puede analizarla usando capacidades de vision (requiere un modelo compatible como GPT-4o o Gemini).
Plugins de IA: Los ai_plugins permiten extender el comportamiento de la IA con funciones personalizadas (consultar base de datos, realizar acciones, etc.).
Prompt del sistema: Cada clave de IA tiene un prompt de sistema configurable que define la personalidad, tono y alcance de las respuestas del chatbot.
Clave de IA: Configura tus claves de IA en Dashboard > IA > Claves. Cada clave define el proveedor, modelo y configuracion del chatbot.

Flujos multi-paso (Flows)

Los flujos permiten crear conversaciones guiadas paso a paso. Cada flujo es una secuencia de acciones que se ejecutan en orden cuando el contacto interactua con el chatbot.

Tipos de pasos disponibles

Paso	Descripcion	Uso tipico
AI Reply	La IA genera una respuesta contextual basada en el mensaje del contacto y el historial de la conversacion.	Chatbot conversacional, soporte al cliente, recopilacion de informacion.
Save Contact	Guarda o actualiza la informacion del contacto (nombre, email, campos personalizados).	Registro de leads, actualizacion de datos de clientes.
Send Message	Envia un mensaje predefinido al contacto (texto, imagen o documento).	Confirmaciones, instrucciones, envio de catalogos o documentos.

Pausar y reanudar flujos

Los flujos y auto-respuestas se pueden pausar para un contacto especifico usando palabras clave de control. Esto es util cuando necesitas intervenir manualmente en una conversacion.

Tipo de pausa	Valor	Descripcion
`autoreply`	Solo auto-respuestas	Pausa unicamente las reglas de auto-respuesta por keyword para ese contacto. Los flujos siguen activos.
`flow`	Solo flujos	Pausa unicamente los flujos multi-paso para ese contacto. Las auto-respuestas por keyword siguen activas.
`all`	Todo	Pausa tanto auto-respuestas como flujos para ese contacto. Ningun mensaje automatico sera enviado.

Ejemplo: crear auto-respuesta por keyword

Este ejemplo crea una auto-respuesta que se activa cuando un contacto envia un mensaje que contiene la palabra "precio" o "precios".

cURL — Crear auto-respuesta (contiene keyword)

curl -X POST \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "secret=TU_API_KEY" \
  -d "type=add.autoreply" \
  -d "name=Respuesta precios" \
  -d "source=2" \
  -d "match=2" \
  -d "keywords=precio,precios,tarifas,coste" \
  -d "account=ACCOUNT_ID" \
  -d "message=Gracias por tu interes! Nuestros precios comienzan desde 29€/mes. Visita nuestra web para mas detalles." \
  -d "message_type=text" \
  -d "group_trigger=2" \
  "//whatsboost.netdashboard/requests"

Ejemplo: crear auto-respuesta con IA

cURL — Crear auto-respuesta con IA

curl -X POST \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "secret=TU_API_KEY" \
  -d "type=add.autoreply" \
  -d "name=Chatbot IA principal" \
  -d "source=2" \
  -d "match=6" \
  -d "account=ACCOUNT_ID" \
  -d "ai_key=3" \
  -d "group_trigger=2" \
  "//whatsboost.netdashboard/requests"