Documentation Index
Fetch the complete documentation index at: https://docs.whaapy.com/llms.txt
Use this file to discover all available pages before exploring further.
Acciones de automatizaciones
Las acciones definen qué hace Whaapy cuando el disparador de una automatización coincide.
Las acciones se ejecutan en orden. Ese orden importa: no es lo mismo asignar un agente antes de enviar un mensaje que hacerlo después.
Acciones disponibles
| Acción | Para qué sirve |
|---|
add_tag | Agregar una etiqueta al contacto |
remove_tag | Quitar una etiqueta |
set_custom_field | Guardar un valor en un campo personalizado |
move_funnel_stage | Mover el contacto a una etapa del funnel |
send_message | Enviar texto, botones o listas |
send_template | Enviar un template aprobado de WhatsApp |
toggle_ai | Activar, apagar o pausar la IA |
http_request | Llamar un endpoint externo |
assign_agent | Asignar la conversación a un miembro del equipo |
update_contact | Mapear valores hacia campos del contacto |
Orden recomendado
Para una automatización comercial típica:
Clasificar
Agrega tag o actualiza custom fields.
Mover
Cambia etapa del funnel si aplica.
Asignar
Asigna agente o equipo responsable.
Responder
Envía mensaje o template.
Coordinar IA
Pausa o apaga la IA si el flujo ya fue cubierto.
Notificar externo
Envía HTTP request o deja que n8n tome el flujo si necesitas orquestación compleja.
Mensajes
send_message sirve para responder dentro de la ventana de 24 horas de WhatsApp.
Puede ser:
- texto simple
- botones
- lista
Ejemplo:
¡Gracias por escribirnos! Ya asignamos tu solicitud al equipo correcto.
Si el cliente está fuera de la ventana de 24 horas, usa send_template en lugar de mensaje libre.
Templates
send_template usa templates aprobados por Meta.
Úsalo para:
- primer contacto
- mensajes fuera de ventana de 24 horas
- confirmaciones
- recordatorios
- seguimiento comercial
Puedes llenar variables del template con valores estáticos o variables de Whaapy.
Ver Variables.
Control de IA
toggle_ai permite coordinar automatizaciones con el agente IA.
Modos típicos:
| Modo | Cuándo usarlo |
|---|
| Encender IA | Retomar automatización conversacional después de un flujo manual |
| Apagar IA | Casos que deben quedar en atención humana |
| Pausar IA | Evitar doble respuesta por un tiempo |
HTTP request
http_request llama un endpoint externo.
Úsalo para:
- enviar lead a CRM
- notificar Slack o Discord
- disparar un webhook de n8n
- crear ticket en helpdesk
- avisar a un sistema propio
Buenas prácticas:
- usa HTTPS
- define timeout corto
- envía solo datos necesarios
- prueba el webhook antes de activar
- no dependas de respuestas lentas
Si el flujo externo tiene muchos pasos, usa n8n y llama un webhook de n8n desde la automatización.
Asignar agente
assign_agent decide quién debe atender la conversación.
Modos:
| Modo | Cómo funciona |
|---|
fixed | Siempre asigna al mismo agente |
round_robin | Rota entre agentes |
least_loaded | Elige quien tiene menos carga activa |
random | Elige uno al azar del pool |
update_contact sirve para mapear datos hacia el contacto.
Es especialmente útil con Meta Lead Ads:
{{lead.field.email}} -> email
{{lead.field.company}} -> company
{{lead.field.city}} -> city
Acciones seguras vs riesgosas
| Acción | Riesgo | Recomendación |
|---|
| Agregar tag | Bajo | Buena primera acción |
| Mover etapa | Medio | Asegúrate de que el trigger sea correcto |
| Enviar mensaje | Medio | Evita dobles respuestas con IA |
| Enviar template | Medio | Revisa variables y aprobación |
| HTTP request | Medio/alto | Prueba y limita payload |
| Asignar agente | Medio | Usa fallback |
| Pausar/apagar IA | Medio | Documenta cuándo se reactiva |
Errores comunes
| Error | Qué pasa | Cómo evitarlo |
|---|
| Muchas acciones en una sola regla | Difícil de depurar | Divide en reglas claras |
| Enviar mensaje y dejar IA activa | Doble respuesta | Usa Omitir IA o toggle_ai |
| HTTP request sin prueba | Fallos silenciosos | Usa test webhook |
| Template con variable vacía | Mensaje raro o inválido | Usa variables con fallback operativo |
| Asignar sin fallback | Conversación sin dueño | Define agente alterno |
Siguiente paso
Aprende a insertar datos dinámicos en Variables.
