Lançamento seguro

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 · PUT 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.

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

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 · 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 é 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.

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:

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.

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.

A seguir: Operar e solucionar problemas

Controle conversas ao vivo, processe eventos, inspecione logs e lide com falhas após o lançamento.

Primeiros passos

Guias

Endpoints

Webhooks

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

Ler as configurações efetivas

Definir orçamentos do agente

Expandir para o público completo

Reverter quando necessário

A seguir: Operar e solucionar problemas

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

​Ler as configurações efetivas

​Definir orçamentos do agente

​Expandir para o público completo

​Reverter quando necessário

A seguir: Operar e solucionar problemas

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

Ler as configurações efetivas

Definir orçamentos do agente

Expandir para o público completo

Reverter quando necessário