Implementación segura

La implementación tiene dos controles independientes: rollout.enabled determina si el agente está habilitado y ai_audience determina quién puede recibir las respuestas del agente. Referencia de la API: GET Get Settings · PUT Replace Settings

Habilitar el agente para los destinatarios en la lista de permitidos

Mantenga la audiencia restringida durante las primeras pruebas en vivo de WhatsApp.

curl --request PUT \
  "https://api.ycloud.com/v2/metaBusinessAgents/$PHONE_NUMBER_ID/settings" \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "rollout": {"enabled": true},
    "ai_audience": "ALLOWLISTED_ONLY"
  }'

Envíe mensajes representativos desde cada número de prueba en la lista de permitidos y confirme que los números que no están en la lista no reciban respuestas del agente.

Leer la configuración efectiva

curl "https://api.ycloud.com/v2/metaBusinessAgents/$PHONE_NUMBER_ID/settings" \
  --header "X-API-Key: $YCLOUD_API_KEY"

La respuesta es una matriz incluso cuando solo existe un objeto de configuración. Verifique tanto rollout.enabled como ai_audience después de cada cambio en la implementación.

Establecer presupuestos del agente

Los presupuestos limitan el uso de tokens o turnos de IA durante un período de tiempo continuo. YCloud utiliza el ID del número de teléfono de WhatsApp Business para encontrar el Business Manager asociado. Referencia de la API: GET Get Budgets · PUT Replace Budgets

curl --request PUT \
  "https://api.ycloud.com/v2/metaBusinessAgents/$PHONE_NUMBER_ID/budgets" \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "budgets": [
      {
        "unit_type": "token",
        "time_window": "one_day",
        "max_budget": 10000
      },
      {
        "unit_type": "ai_turn",
        "time_window": "seven_days",
        "max_budget": 500
      }
    ]
  }'

unit_type es token o ai_turn. time_window es one_day, seven_days, fourteen_days o thirty_days. max_budget debe ser un número entero positivo. PUT reemplaza la colección completa de presupuestos. Incluya budget_id para cada presupuesto existente que desee conservar y omítalo para un presupuesto nuevo. Cada par (unit_type, time_window) debe ser único. Envíe {"budgets":[]} para eliminar todos los límites. Vuelva a leer la colección después de cada reemplazo.

Expandir a toda la audiencia

Cambie solo la audiencia después de que la implementación en la lista de permitidos pase las pruebas de aceptación.

curl --request PUT \
  "https://api.ycloud.com/v2/metaBusinessAgents/$PHONE_NUMBER_ID/settings" \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"ai_audience":"EVERYONE"}'

YCloud deja sin cambios la configuración omitida. Vuelva a leer la configuración y supervise las conversaciones reales antes de considerar que la implementación está completa.

Revertir cuando sea necesario

Mantenga esta solicitud lista antes de expandir la audiencia:

curl --request PUT \
  "https://api.ycloud.com/v2/metaBusinessAgents/$PHONE_NUMBER_ID/settings" \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "rollout": {"enabled": false},
    "ai_audience": "ALLOWLISTED_ONLY"
  }'

Lea la configuración efectiva después de la reversión. Deshabilitar la implementación no elimina el agente, el conocimiento, las habilidades ni los conectores.

Habilitar la implementación cambia el manejo de mensajes en vivo. Coordine la propiedad con los equipos de soporte humano y no utilice a toda la audiencia como sustituto para completar las pruebas de aceptación restringidas.

Siguiente: Operar y solucionar problemas

Controle las conversaciones en vivo, procese eventos, inspeccione registros y maneje fallas después del lanzamiento.

Primeros pasos

Guías

Endpoints

Webhooks

Implementación segura

Habilitar el agente para los destinatarios en la lista de permitidos

Leer la configuración efectiva

Establecer presupuestos del agente

Expandir a toda la audiencia

Revertir cuando sea necesario

Siguiente: Operar y solucionar problemas

​Habilitar el agente para los destinatarios en la lista de permitidos

​Leer la configuración efectiva

​Establecer presupuestos del agente

​Expandir a toda la audiencia

​Revertir cuando sea necesario

Siguiente: Operar y solucionar problemas

Habilitar el agente para los destinatarios en la lista de permitidos

Leer la configuración efectiva

Establecer presupuestos del agente

Expandir a toda la audiencia

Revertir cuando sea necesario