> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Implementación segura

> Habilite Meta Business Agent por etapas, verifique cada cambio de configuración y mantenga lista una solicitud de reversión probada.

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](/api-reference/meta-business-agents/get-settings) · [PUT Replace Settings](/api-reference/meta-business-agents/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.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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](/api-reference/meta-business-agents/get-budgets) · [PUT Replace Budgets](/api-reference/meta-business-agents/replace-budgets)

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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.

<Warning>
  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.
</Warning>

<Card title="Siguiente: Operar y solucionar problemas" icon="arrow-right" href="/es/documentation/meta-business-agent/operate-and-troubleshoot">
  Controle las conversaciones en vivo, procese eventos, inspeccione registros y maneje fallas después del lanzamiento.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.