Editar uma campanha oficial

Atualiza só as configurações: nome, modelo, número, funil, fluxo, agente, ferramentas de IA e agendamento. Os contatos não mudam por aqui; phoneNumbers no corpo é ignorado (use POST /v1/whatsapp/campaigns/{id}/entries). Arquivar não muda por aqui (use /archive e /unarchive). O modelo e o número só são conferidos quando mudam: modelo pronto para envio (422 campaign_template_not_ready), da mesma conta do número (422 campaign_template_phone_mismatch) e preenchível pelos contatos que ainda aguardam envio (400 campaign_template_variables_missing). Trocar o modelo passa pela regra de saída da criação (422 exit_risk_not_acknowledged sem exitRiskAcknowledged: true). Uma campanha preparada a partir de leads recusa a troca do modelo ou do número com 409 send_selection_locked. Quando o fluxo ou o agente mudam, cada contato salvo precisa ter as variáveis que ele pede (400 campaign_workflow_vars_missing ou agent_required_variable_missing); fluxo de outro workspace 403 campaign_workflow_forbidden, inexistente 400 campaign_workflow_not_found ou campaign_agent_not_found. scheduledStart vazio desliga o agendamento; um novo horário precisa ficar entre 5 minutos e 1 ano (400 campaign_schedule_in_past ou campaign_schedule_out_of_window) e não vale para campanha em execução (409 campaign_running). Um agendamento novo ou mantido passa pela mesma verificação do Iniciar sobre a campanha já editada: um bloqueio responde 409 campaign_launch_blocked e riscos novos pedem confirmação com 409 campaign_launch_unconfirmed (reenvie com o confirmedFingerprint de details.fingerprint); riscos já confirmados no agendamento não pedem de novo. Nada é salvo nesses casos, e sem a verificação disponível responde 503 campaign_launch_check_unavailable. Uma campanha preparada a partir de leads não pode ser agendada (409 send_schedule_from_leads). Quem salva o agendamento é quem recebe a notificação se ele não iniciar no horário; o motivo fica em scheduleFailure até a campanha iniciar ou ser agendada de novo. Definir ou manter um agendamento exige a permissão de iniciar campanhas (403 start_permission_required); editar sem agendamento exige só a de editar.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Campanha

Body Params

Configurações da campanha

string
string
string
string
string
boolean
boolean
boolean
boolean
boolean
boolean
string
phoneNumbers
array of objects
phoneNumbers
string
recipients
object
string
boolean
smartPolicy
object
string
string
string
string
Headers
string

Departamento que limita os dados. Quem não participa do departamento recebe 403; donos e administradores escolhem qualquer um.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json