Alterar dados
As escritas seguem as mesmas regras do painel e usam a mesma capacidade e o mesmo limite mensal de trocas.
Pré-visualize primeiro
curl -X POST https://api.messgeo.com/v1/panels/PANEL_ID/prompts \
-H "Authorization: Bearer mgk_xxxxxxxxxx_your_secret" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: my-unique-key-002" \
-d '{"prompts": [{"text": "best ai visibility tools for agencies"}], "dry_run": true}'Todas as escritas aceitam dry_run: true: mostra o efeito, nada escreve e não conta para a quota mensal. Um Idempotency-Key torna a repetição segura.
Chamadas
| Chamada | Efeito |
|---|---|
POST /panels/{panel_id}/prompts | Adiciona prompts, no máximo 20. Os novos prompts são medidos de imediato, como no painel |
PATCH /panels/{panel_id}/prompts/{prompt_id} | Altera estado, tópico, etiquetas, categoria e prioridade. O texto não muda |
DELETE /panels/{panel_id}/prompts/{prompt_id} | Desativa um prompt. O histórico mantém-se, as oportunidades guardadas são removidas |
POST /panels/{panel_id}/competitors | Adiciona um concorrente, no máximo 15 no Starter e 25 no Pro |
DELETE /panels/{panel_id}/competitors/{competitor_id} | Remove um concorrente. Envie confirm: true |
PUT /panels/{panel_id}/aliases | Substitui os nomes adicionais, no máximo 10 |
POST /panels/{panel_id}/actions/{action_id}/done, /undo | Marca uma ação como concluída ou remove-a |
POST /panels/{panel_id}/opportunities/mark | Marca uma fonte como added ou dismissed, ou undo |
PATCH /me/alert-prefs | Preferências de email da conta |
PATCH /panels/{panel_id} | País, idioma, motores. Remover um motor exige confirm: true |
POST /panels/{panel_id}/pause, /resume | Pausa ou retoma as medições |
DELETE /panels/{panel_id} | Apaga o painel. Envie confirm: true |
PATCH /panels/{panel_id}/prompts | Ativa ou desativa até 150 prompts |
POST /panels/{panel_id}/actions | Adiciona ou planeia uma ação |
POST /panels/{panel_id}/shares | Cria uma ligação protegida |
POST /panels/{panel_id}/integrations/{service}/sync | Atualiza o Search Console ou Analytics |
Capacidade e trocas
Um painel pode ter tantos prompts ativos quantos o pacote permitir, e adicionar até esse nível é gratuito. Substituir prompts usa o limite mensal de trocas. Quando não chega, a chamada devolve 422 prompt_budget_exceeded com reason e remaining, e nada é escrito.
O que a API não altera
Pagamentos, subscrições, apagar a conta e funções de administrador ficam no painel. Ligar o Search Console ou Analytics exige consentimento Google no navegador: /integrations devolve o endereço.