Crear nueva configuración de handler

POST

/whatsapp-handler-configs

curl --request POST \
  --url https://api.matiasimpulso.com/whatsapp-handler-configs \
  --header 'Content-Type: application/json' \
  --data '{ "whatsappId": 1, "handlerType": "ai_agent", "handlerId": 1, "priority": 1, "executionOrder": 1, "triggerType": "on_message_received", "isActive": true, "config": {}, "queueId": 1, "integrationId": 1, "integrationType": "typebot", "webhookUrl": "example", "secret": "example", "timeoutMs": 1, "pauseAi": true, "maxMessagesPerSession": 50, "maxSessionDuration": 1800, "rateLimitPerMinute": 10, "costLimitPerSession": 1, "maxTokensPerMessage": 2000, "maxRetries": 3 }'

• Servidor de Producción (Cloud)
• Entorno de Desarrollo Local

Request Body^required

Media type application/json

object

whatsappId

required

ID del canal WhatsApp

number

handlerType

required

Tipo de handler

string

Allowed values: ai_agent ai_router flow integration

handlerId

ID del handler específico (agentId, flowId, etc.)

number

priority

required

Prioridad de ejecución (1 = primero)

number

default: 1 >= 1 <= 100

executionOrder

required

Orden de ejecución dentro de misma prioridad

number

default: 1 >= 1

triggerType

required

Tipo de trigger que activa el handler

string

default: on_message_received

Allowed values: on_message_received on_ticket_created on_keyword_detected on_schedule on_manual

isActive

required

Handler activo

boolean

default: true

config

Configuración personalizada del handler (JSON)

object

key

additional properties

any

queueId

ID de cola (si handlerType = queue)

number

integrationId

ID de integración (si handlerType = integration)

number

integrationType

Tipo de integración externa (si handlerType = integration)

string

Allowed values: typebot n8n make zapier custom

webhookUrl

URL HTTPS del webhook externo (si handlerType = integration)

string

secret

Secreto de firma HMAC write-only (si handlerType = integration)

string

nullable

timeoutMs

Timeout en milisegundos para la integración externa

number

pauseAi

Pausar IA mientras responde la integración externa

boolean

maxMessagesPerSession

Máximo de mensajes por sesión antes de escalar

number

default: 50 >= 1 <= 1000

maxSessionDuration

Duración máxima de sesión en segundos (30 min default)

number

default: 1800 >= 60 <= 86400

rateLimitPerMinute

Máximo de mensajes por minuto por usuario

number

default: 10 >= 1 <= 100

costLimitPerSession

Límite de costo en USD por sesión (para IA)

number

default: 1

maxTokensPerMessage

Máximo de tokens por mensaje (para IA)

number

default: 2000 >= 100 <= 10000

maxRetries

Máximo de reintentos ante error

number

default: 3 <= 10

Responses

201

Configuración creada exitosamente

404

Canal WhatsApp no encontrado

409

Configuración duplicada (conflicto de unicidad)