Ir al contenido

Actualizar configuración de handler

PATCH
/whatsapp-handler-configs/{id}
curl --request PATCH \
--url https://api.matiasimpulso.com/whatsapp-handler-configs/1 \
--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 }'
id
required
number

ID de la configuración

Media type application/json
object
whatsappId

ID del canal WhatsApp

number
handlerType

Tipo de handler

string
Allowed values: ai_agent ai_router flow integration
handlerId

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

number
priority

Prioridad de ejecución (1 = primero)

number
default: 1 >= 1 <= 100
executionOrder

Orden de ejecución dentro de misma prioridad

number
default: 1 >= 1
triggerType

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

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

Configuración actualizada exitosamente

Configuración no encontrada

Conflicto de unicidad en actualización