> ## 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.

# Lançamento seguro

> Ative o Meta Business Agent em etapas, verifique cada alteração de configuração e mantenha uma solicitação de reversão testada pronta.

O lançamento tem dois controles independentes: `rollout.enabled` determina se o agente está ativado e `ai_audience` determina quem pode receber respostas do agente.

**Referência da API:** [GET Get Settings](/api-reference/meta-business-agents/get-settings) · [PUT Replace Settings](/api-reference/meta-business-agents/replace-settings)

## Ativar o agente para destinatários na lista de permissões

Mantenha o público restrito durante os primeiros testes ao vivo do 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"
  }'
```

Envie mensagens representativas de cada número de teste na lista de permissões e confirme se os números que não estão na lista de permissões não recebem respostas do agente.

## Ler as configurações efetivas

```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"
```

A resposta é um array mesmo quando existe apenas um objeto de configurações. Verifique `rollout.enabled` e `ai_audience` após cada alteração de lançamento.

## Definir orçamentos do agente

Os orçamentos limitam o uso de tokens ou turnos de IA em uma janela de tempo contínua. A YCloud usa o ID do número de telefone do WhatsApp Business para encontrar o Gerenciador de Negócios associado.

**Referência da 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` é `token` ou `ai_turn`. `time_window` é `one_day`, `seven_days`, `fourteen_days` ou `thirty_days`. `max_budget` deve ser um número inteiro positivo.

`PUT` substitui a coleção completa de orçamentos. Inclua `budget_id` para cada orçamento existente que você deseja manter e omita-o para um novo orçamento. Cada par `(unit_type, time_window)` deve ser exclusivo. Envie `{"budgets":[]}` para remover todos os limites. Leia a coleção novamente após cada substituição.

## Expandir para o público completo

Altere apenas o público após o lançamento na lista de permissões passar no teste de aceitação.

```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"}'
```

As configurações omitidas não são alteradas pela YCloud. Leia as configurações novamente e monitore as conversas reais antes de tratar o lançamento como concluído.

## Reverter quando necessário

Mantenha esta solicitação pronta antes de expandir o público:

```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"
  }'
```

Leia as configurações efetivas após a reversão. Desativar o lançamento não exclui o agente, o conhecimento, as habilidades ou os conectores.

<Warning>
  Ativar o lançamento altera o tratamento de mensagens ao vivo. Coordene a propriedade com as equipes de suporte humano e não use o público completo como substituto para concluir os testes de aceitação restritos.
</Warning>

<Card title="A seguir: Operar e solucionar problemas" icon="arrow-right" href="/pt/documentation/meta-business-agent/operate-and-troubleshoot">
  Controle conversas ao vivo, processe eventos, inspecione logs e lide com falhas após o lançamento.
</Card>


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