Pular para o conteúdo
DELETE/regras-comentario/{id}

Apagar regra de comentário

automacoes:escrevermódulo Automações

Sem volta. Para só pausar, use PATCH com ativo: false.

DELETE /regras-comentario/{id}

curl -X DELETE "https://chat.forsi.com.br/api/v1/regras-comentario/7f0a344c-4fb9-4180-8d9b-46d51ab38635" \
  -H "Authorization: Bearer $FORSI_CHAVE"
Resposta 200
{"dados":{"apagado":false}}

Parâmetros no caminho#

  • iduuidobrigatório

    No caminho da URL.

Resposta#

200 com {"dados": ...}: ApagadoRegra.

  • apagadobooleanopcional
    —

Erros#

Todo erro vem como {"erro": {"codigo", "mensagem"}}. Trate pelo codigo: ele não muda.

Status de erro desta operação
StatusQuando
401Chave ausente ou inválida (resposta igual para qualquer motivo).
403Plano sem API, escopo insuficiente ou https/origem recusados.
404Não existe nesta organização.
409Conflito (repetido, Idempotency-Key com outro corpo).
422Dados inválidos ou regra de negócio (ex.: janela_fechada; conta_restrita = a Meta restringiu a conta por spam: erro traz os campos de RestricaoMeta, como ate, escopo, motivo e retry_after_s).
429Limite de requisições. Veja Retry-After.
Códigos de erro que esta área pode devolver19
  • regra_inexistenteRegra de comentário não encontrada (veja GET /regras-comentario).
  • regra_conexao_invalidaconexao_id precisa ser uma conta do Instagram conectada por login (veja GET /instagram/contas).
  • regra_sem_palavrasInforme de 1 a 30 palavras, ou use qualquer_comentario: true.
  • regra_modo_invalidomodo deve ser contem ou igual.
  • regra_sem_acaoA regra precisa de uma resposta pública ou de uma resposta privada.
  • regra_texto_longoTexto longo demais: resposta pública até 2200 caracteres e resposta privada até 1000.
  • regra_variantes_demaisNo máximo 5 respostas_publicas.
  • regra_extra_sem_publicorespostas_publicas e ocultar_apos só valem com responder_publico preenchido.
  • regra_automacao_invalidaautomacao_id não é uma automação desta organização (veja GET /automacoes?gatilho=comentario).
  • regra_automacao_sem_privadaPara ligar uma automação, preencha resposta_privada.
  • regra_botao_longoCada botão tem no máximo 20 caracteres.
  • regra_botao_repetidoBotões repetidos. Cada botão deve ser diferente.
  • regra_botao_url_invalidaA url do botão deve ser um link https:// válido, com até 2000 caracteres.
  • regra_botoes_demaisNo máximo 3 botões.
  • regra_botoes_invalidosbotoes deve ser uma lista de textos ou de objetos { titulo, url }.
  • regra_botoes_sem_privadaPara ter botões, preencha resposta_privada.
  • recurso_desligadoEste recurso não está liberado para a sua organização.
  • seguir_invalidoAlgum campo de `seguir` é inválido. A mensagem diz qual: textos de 1 a 640 caracteres (os de "já segue" e "seguiu depois" podem ser vazios), botões de 1 a 20 e sem `{` (botão não troca variáveis), cada texto até 900 bytes (emoji e acento contam mais), sem caractere de controle ou invisível, `max_tentativas` de 1 a 50 e link do conteúdo em https.
  • limite_de_regrasLimite de 200 regras de comentário por organização. Apague alguma para criar outra.

Os erros que valem para qualquer rota (chave, limite, JSON) estão em Erros.