Pular para o conteúdo
GET/negocios/{id}/notas

Notas de um negócio

funil:lermódulo Funilpaginada

Da mais nova para a mais antiga.

GET /negocios/{id}/notas

curl "https://chat.forsi.com.br/api/v1/negocios/b04efa09-d26e-496a-a843-fb12f9be4d4d/notas?limite=20" \
  -H "Authorization: Bearer $FORSI_CHAVE"
Resposta 200
{
  "dados": [
    {
      "id": "68375c45-c8b3-4632-9968-1bd256569205",
      "negocio_id": "b04efa09-d26e-496a-a843-fb12f9be4d4d",
      "texto": "Pediu para ligar depois das 18h.",
      "autor_id": "7aded196-b699-4ef0-b171-2a17b934d051",
      "autor": "Ana Lima",
      "criado_em": "2026-10-04T13:05:12.481Z"
    }
  ],
  "proximo": "1791205512481_3791c08d-72dd-4002-89ff-1e14a11c07e5"
}

Parâmetros no caminho#

  • iduuidobrigatório

    No caminho da URL.

Parâmetros de consulta#

  • limiteintegeropcional

    Itens por página (1 a 100, padrão 50).

  • cursorstringopcional

    Valor de proximo da página anterior.

    • até 80 caracteres

Resposta#

200 com {"dados": ...}: uma lista de NotaNegocio, paginada por cursor (como paginar).

  • iduuidopcional
    —
  • negocio_iduuidopcional
    —
  • textostringopcional
    —
  • autor_iduuid ou nullopcional
    —
  • autorstring ou nullopcional
    —
  • criado_emdata e hora ISO 8601opcional
    —

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.
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 devolver13
  • funil_inexistenteFunil não encontrado.
  • etapa_inexistenteEtapa não encontrada (veja GET /funis).
  • negocio_inexistenteNegócio não encontrado.
  • nota_inexistenteNota não encontrada.
  • etapa_fora_do_funilEssa etapa não pertence ao funil informado.
  • etapa_ganha_e_perdidaUma etapa não pode ser de ganho e de perda ao mesmo tempo.
  • estado_invalidoestado deve ser aberto, ganho ou perdido.
  • valor_invalidoO valor não pode ser negativo.
  • limite_de_funisLimite de 20 funis por organização.
  • limite_de_etapasLimite de 30 etapas por funil.
  • limite_de_notasLimite de 500 notas por negócio.
  • contato_inexistenteContato não encontrado.
  • conversa_inexistenteConversa não encontrada.

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