API atual/Referência completa/WhatsApp: resultados

Orçamento mensal

Define quanto a loja aceita gastar por mês com mensagens do WhatsApp e se as campanhas param ao atingir o teto.

O orçamento é um limite mensal de gasto estimado com mensagens da Meta. Existe um por loja. Com o teto rígido (hard_cap) ligado, quando o gasto do mês alcança o valor, as campanhas em envio voltam para a fila. O orçamento nunca bloqueia respostas da caixa de entrada nem do assistente: só o disparo de campanhas.

Ler o orçamento

GET/api/v1/vendor/whatsapp-confluence/budgetSeller

Retorna o orçamento e o gasto do mês

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um usuário seller (lojista). Veja Tokens.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/vendor/whatsapp-confluence/budget" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Orçamento

json

{
  "budget": {
    "monthly_budget_cents": 50000,
    "alert_thresholds": [
      50,
      80,
      100
    ],
    "hard_cap": true
  },
  "spent_cents": 4200
}

Campos da resposta

budgetobject

O orçamento salvo.

monthly_budget_centsinteger

Limite mensal em centavos (50000 = R$ 500,00). Omitido quando não há limite.

alert_thresholdsarray

Percentuais do orçamento marcados para alerta. [50, 80, 100] enquanto o orçamento nunca foi salvo. Um salvamento que omitiu o campo deixa null.

hard_capboolean

true pausa as campanhas ao atingir o limite.

spent_centsinteger

Gasto estimado do mês corrente, em centavos.

Erros

Status	Quando	Corpo de exemplo
401	Sem token ou token inválido.	`{"error":"missing authorization header"}`
403	O usuário não é um seller, ou o seller ainda está em análise de cadastro.	`{"error":"vendor_pending_review"}`
500	Falha interna ao calcular.	`{"error":"..."}`

Gravar o orçamento

A gravação substitui o orçamento inteiro. Para manter um limite, envie monthly_budget_cents de novo: omitido, o limite é removido. Só o administrador ou o seller dono do WhatsApp da loja grava.

PUT/api/v1/vendor/whatsapp-confluence/budgetSeller

Define o orçamento mensal

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um usuário seller (lojista). Veja Tokens.

Content-Typestringobrigatório

application/json.

Corpo da requisição

monthly_budget_centsinteger

Limite mensal em centavos. Omitido ou null remove o limite.

alert_thresholdsarray

Percentuais para alerta. Omitido grava null (não volta para [50, 80, 100]), então envie sempre a lista.

hard_capboolean

Pausar campanhas ao atingir o limite. Omitido vale false.

Exemplo de requisição

bash

curl -X PUT "$BASE_URL/api/v1/vendor/whatsapp-confluence/budget" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "monthly_budget_cents": 50000,
  "alert_thresholds": [
    50,
    80,
    100
  ],
  "hard_cap": true
}'

Resposta

200Orçamento gravado

json

{
  "status": "ok"
}

Campos da resposta

statusstring

Sempre ok. A rota não devolve o orçamento; leia-o de novo.

Erros

Status	Quando	Corpo de exemplo
401	Sem token ou token inválido.	`{"error":"missing authorization header"}`
403	Falta o privilégio `vendor_settings` ou `vendor_manage_whatsapp`, ou o WhatsApp da loja não é deste seller.	`{"error":"store_whatsapp_owner_required"}`
400	Corpo que não é JSON, ou `monthly_budget_cents` que não é inteiro.	`{"error":"invalid body"}`
500	Falha interna ao calcular.	`{"error":"..."}`

Veja também

Orçamento mensal

Define quanto a loja aceita gastar por mês com mensagens do WhatsApp e se as campanhas param ao atingir o teto.

Ler o orçamento

GET/api/v1/vendor/whatsapp-confluence/budgetSeller

Retorna o orçamento e o gasto do mês

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um usuário seller (lojista). Veja Tokens.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/vendor/whatsapp-confluence/budget" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Orçamento

json

{
  "budget": {
    "monthly_budget_cents": 50000,
    "alert_thresholds": [
      50,
      80,
      100
    ],
    "hard_cap": true
  },
  "spent_cents": 4200
}

Campos da resposta

budgetobject

O orçamento salvo.

monthly_budget_centsinteger

Limite mensal em centavos (50000 = R$ 500,00). Omitido quando não há limite.

alert_thresholdsarray

Percentuais do orçamento marcados para alerta. [50, 80, 100] enquanto o orçamento nunca foi salvo. Um salvamento que omitiu o campo deixa null.

hard_capboolean

true pausa as campanhas ao atingir o limite.

spent_centsinteger

Gasto estimado do mês corrente, em centavos.

Erros

Status	Quando	Corpo de exemplo
401	Sem token ou token inválido.	`{"error":"missing authorization header"}`
403	O usuário não é um seller, ou o seller ainda está em análise de cadastro.	`{"error":"vendor_pending_review"}`
500	Falha interna ao calcular.	`{"error":"..."}`

Gravar o orçamento

PUT/api/v1/vendor/whatsapp-confluence/budgetSeller

Define o orçamento mensal

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um usuário seller (lojista). Veja Tokens.

Content-Typestringobrigatório

application/json.

Corpo da requisição

monthly_budget_centsinteger

Limite mensal em centavos. Omitido ou null remove o limite.

alert_thresholdsarray

Percentuais para alerta. Omitido grava null (não volta para [50, 80, 100]), então envie sempre a lista.

hard_capboolean

Pausar campanhas ao atingir o limite. Omitido vale false.

Exemplo de requisição

bash

curl -X PUT "$BASE_URL/api/v1/vendor/whatsapp-confluence/budget" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "monthly_budget_cents": 50000,
  "alert_thresholds": [
    50,
    80,
    100
  ],
  "hard_cap": true
}'

Resposta

200Orçamento gravado

json

{
  "status": "ok"
}

Campos da resposta

statusstring

Sempre ok. A rota não devolve o orçamento; leia-o de novo.

Erros

Status	Quando	Corpo de exemplo
401	Sem token ou token inválido.	`{"error":"missing authorization header"}`
403	Falta o privilégio `vendor_settings` ou `vendor_manage_whatsapp`, ou o WhatsApp da loja não é deste seller.	`{"error":"store_whatsapp_owner_required"}`
400	Corpo que não é JSON, ou `monthly_budget_cents` que não é inteiro.	`{"error":"invalid body"}`
500	Falha interna ao calcular.	`{"error":"..."}`