Control de IA por Conversación

Controla el comportamiento de la IA a nivel de conversación individual. Útil cuando un agente humano toma el control o cuando quieres que la IA no responda a ciertos clientes.

Activar/Desactivar

Control permanente de IA

Pausar Temporalmente

Pausa por X minutos

Activar o Desactivar IA

Controla permanentemente si la IA puede responder en esta conversación.

PATCH https://api.whaapy.com/conversations/v1/{id}/ai

Parámetros

string

required

UUID de la conversación

boolean

required

true para activar, false para desactivar

curl -X PATCH "https://api.whaapy.com/conversations/v1/uuid/ai" \
  -H "Authorization: Bearer wha_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "aiEnabled": false }'

const conversationId = 'uuid';
await fetch(
  `https://api.whaapy.com/conversations/v1/${conversationId}/ai`,
  {
    method: 'PATCH',
    headers: {
      'Authorization': 'Bearer wha_xxxxx',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ aiEnabled: false })
  }
);

import requests

conversation_id = 'uuid'
response = requests.patch(
    f'https://api.whaapy.com/conversations/v1/{conversation_id}/ai',
    headers={
        'Authorization': 'Bearer wha_xxxxx',
        'Content-Type': 'application/json'
    },
    json={'aiEnabled': False}
)

{
  "message": "Configuración actualizada",
  "settings": {
    "aiEnabled": false,
    "aiMode": "auto",
    "aiPausedUntil": null
  }
}

Pausar IA Temporalmente

Pausa la IA por un tiempo determinado. Útil cuando un agente humano está atendiendo pero quieres que la IA retome automáticamente después.

POST https://api.whaapy.com/conversations/v1/{id}/ai/pause

Parámetros

string

required

UUID de la conversación

number

default:"5"

Minutos de pausa (1-1440, máximo 24 horas)

curl -X POST "https://api.whaapy.com/conversations/v1/uuid/ai/pause" \
  -H "Authorization: Bearer wha_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "duration": 30 }'

const conversationId = 'uuid';
await fetch(
  `https://api.whaapy.com/conversations/v1/${conversationId}/ai/pause`,
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer wha_xxxxx',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ duration: 30 })
  }
);

import requests

conversation_id = 'uuid'
response = requests.post(
    f'https://api.whaapy.com/conversations/v1/{conversation_id}/ai/pause',
    headers={
        'Authorization': 'Bearer wha_xxxxx',
        'Content-Type': 'application/json'
    },
    json={'duration': 30}
)

{
  "success": true,
  "pausedUntil": "2026-01-29T11:00:00Z",
  "message": "IA pausada por 30 minutos"
}

Usa la pausa temporal cuando un agente humano está atendiendo pero quieres que la IA retome automáticamente después. Si quieres deshabilitar la IA permanentemente, usa el endpoint PATCH /ai con aiEnabled: false.

Prioridad de control

La IA responde a un mensaje solo si TODOS estos niveles están activos:

Niveles de control

Nivel	Endpoint	Prioridad
Global (todo el negocio)	`POST /agent/toggle`	Más alta
Pausa global	`POST /agent/pause`	Alta
Por conversación	`PATCH /conversations/v1/:id/ai`	Media
Pausa por conversación	`POST /conversations/v1/:id/ai/pause`	Baja

Si la IA está desactivada globalmente (POST /agent/toggle), no responderá aunque esté activada a nivel de conversación.

Casos de uso

Agente humano toma el control

Cuando un agente humano comienza a atender, pausa la IA:

// Webhook: agente asignado a conversación
async function onAgentAssigned(conversationId) {
  await fetch(
    `https://api.whaapy.com/conversations/v1/${conversationId}/ai/pause`,
    {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer wha_xxxxx',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({ duration: 60 }) // 1 hora
    }
  );
}

Desactivar IA para cliente VIP

Algunos clientes prefieren atención humana exclusiva:

async function disableAIForVIP(conversationId) {
  await fetch(
    `https://api.whaapy.com/conversations/v1/${conversationId}/ai`,
    {
      method: 'PATCH',
      headers: {
        'Authorization': 'Bearer wha_xxxxx',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({ aiEnabled: false })
    }
  );
}

Reactivar IA después de resolver

Cuando el agente termina, reactiva la IA:

async function onTicketResolved(conversationId) {
  await fetch(
    `https://api.whaapy.com/conversations/v1/${conversationId}/ai`,
    {
      method: 'PATCH',
      headers: {
        'Authorization': 'Bearer wha_xxxxx',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({ aiEnabled: true })
    }
  );
}

Control global vs por conversación

Característica	Global	Por conversación
Afecta a	Todas las conversaciones	Solo una conversación
Endpoint	`POST /agent/toggle`	`PATCH /conversations/v1/:id/ai`
Caso de uso	Mantenimiento, emergencias	Clientes específicos, handoff
Pausa temporal	`POST /agent/pause`	`POST /conversations/v1/:id/ai/pause`

Para control global de la IA, consulta la documentación de Agente IA.

General

Mensajes

Media

Conversaciones

Contactos

Funnels

Templates

Agente IA

Equipo

Webhooks

Control de IA por Conversación

Control de IA por Conversación

Activar/Desactivar

Pausar Temporalmente

Activar o Desactivar IA

Parámetros

Pausar IA Temporalmente

Parámetros

Prioridad de control

Niveles de control

Casos de uso

Control global vs por conversación

​Control de IA por Conversación

Activar/Desactivar

Pausar Temporalmente

​Activar o Desactivar IA

​Parámetros

​Pausar IA Temporalmente

​Parámetros

​Prioridad de control

​Niveles de control

​Casos de uso

​Control global vs por conversación

Control de IA por Conversación

Activar o Desactivar IA

Parámetros

Pausar IA Temporalmente

Parámetros

Prioridad de control

Niveles de control

Casos de uso

Control global vs por conversación