Executa a ação sobre a seleção confirmada. O cabeçalho Idempotency-Key (até 128 caracteres) é obrigatório: a mesma chave com o mesmo pedido devolve o mesmo resultado sem refazer nada, e com outro pedido responde 409 idempotency_key_reused. fingerprint e expectedCount vêm da prévia (ou da contagem da lista) e são obrigatórios fora do modo ids (sem a contagem responde 400 selection_count_required); se a contagem mudou, responde 409 selection_changed com a contagem nova em details.expected e details.matched. classify, assign_owner e block congelam a seleção e respondem 202 com a execução (run), aplicada em lotes de 500 com versão nova e evento por lead alterado; acompanhe por GET /leads/actions/{runId} e pelo evento conversation:leads_bulk_update. Um bloqueio com businessPhoneId confere o número antes (422 lead_action_phone_unavailable) e aplica o bloqueio no WhatsApp depois, sob limite de taxa. export confere o limite de 250.000 leads antes de congelar a seleção e responde 202 com o relatório (report, tipo leads), baixado por GET /reports/{id}/file só por quem pediu ou por quem tem as mesmas permissões. meta_audience congela a seleção (sem leads bloqueados), responde 202 com o público em montagem (audience com id e status pending) e envia à Meta em segundo plano; acompanhe por GET /leads/actions/audiences/{audienceId}. call_list (params callList: name, assigneeIds, phoneSource identity ou contact com phoneLabel) congela a seleção sob o id da lista (até 100.000 leads) e responde 202 com a lista em montagem (callList com status building); os itens são montados em segundo plano, pulando com o motivo os leads bloqueados, que pediram para não ser chamados, ou sem o número escolhido; acompanhe por GET /call-lists/{listId}. send_template e send_unofficial preparam o disparo ("Revisar"): congelam a seleção, montam as variáveis de cada lead, criam uma campanha parada por parte de até 150.000 leads com origem lead_selection e a chave do pedido (repetir o pedido devolve as mesmas campanhas), no departamento de quem pede, e respondem 202 com send, a revisão com as contagens por motivo e a cotação; nada é enviado até POST /leads/actions/sends/start, e POST /leads/actions/sends/cancel exclui o disparo. Sem o escopo de criação de quem pede responde 403 send_creation_scope_missing; numa conta com departamentos, sem departmentId responde 400 send_department_required; acima de 150.000 leads sem split responde 413 send_selection_over_campaign_cap, conferido antes de congelar a seleção. Uma recusa antes de criar qualquer campanha (contagem mudada, tamanho, parâmetros) libera a Idempotency-Key para o pedido corrigido; depois que uma parte existe, a chave fica presa ao pedido. Um segundo pedido com a mesma chave enquanto o primeiro ainda prepara responde 409 send_preparing: tente de novo em instantes. restore_opt_out ("Desfazer saída") exige leads.consent, note (o motivo, de 1 a 280 caracteres; 400 lead_action_note_required ou lead_action_note_too_long) e confirmCount, o número de leads selecionados digitado por quem confirma (selected da prévia; sem ele 400 selection_count_required; diferente da seleção congelada, 409 selection_changed com details.expected e details.matched, e nada é congelado). Congela a seleção e responde 202 com a execução (run), em lotes de 500: para cada lead cuja saída atual foi registrada por automação (button_reply, keyword, ai_agent ou workflow) antes do pedido, restaura o estado anterior àquela saída (sem opt-out e com o consentimento que havia antes, se havia) e grava o evento consent_withdrawal_reverted com quem pediu, a nota e o id do evento de saída desfeito; nunca registra um novo consentimento. Os demais são pulados em skipped: unchanged, gone ou lead_opt_out_not_restorable. A leitura dos leads e a revisão passam pelo limite de consultas analíticas (503 com Retry-After quando ocupado). Permissões como em POST /leads/actions/preview.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||