Pular para o conteúdo
GET/equipe/presenca

Quem está disponível

equipe:lerpaginada

Disponível agora = marcou disponível, não está ausente e está dentro do horário de trabalho (no fuso da organização).

GET /equipe/presenca

curl "https://chat.forsi.com.br/api/v1/equipe/presenca?equipe_id=55174f08-dda3-49e6-bc5d-9309becdaf6d" \
  -H "Authorization: Bearer $FORSI_CHAVE"
Resposta 200
{
  "dados": [
    {
      "id": "9d77cca2-2aa9-45d6-aef4-707f6b6ee109",
      "nome": "Ana Lima",
      "papel": "dono",
      "disponivel": true,
      "disponivel_agora": true,
      "ausente_ate": "2026-10-04T13:05:12.481Z",
      "horario": {"dias":[1,2,3,4,5],"inicio":"08:00","fim":"18:00"},
      "ultimo_acesso": "2026-10-04T13:05:12.481Z"
    }
  ],
  "proximo": "1791205512481_3791c08d-72dd-4002-89ff-1e14a11c07e5"
}

Parâmetros de consulta#

  • equipe_iduuidopcional

    Só quem está nesta equipe.

  • limiteintegeropcional

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

  • cursorstringopcional

    O valor de proximo da página anterior.

    • até 80 caracteres

Resposta#

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

  • iduuidopcional
    —
  • nomestringopcional
    —
  • papel"dono" | "gestor" | "atendente"opcional
    —
  • disponivelbooleanopcional
    —
  • disponivel_agorabooleanopcional
    —
  • ausente_atedata e hora ISO 8601opcional
    —
  • horarioobjeto livreopcional
    —
  • ultimo_acessodata 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.
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 devolver12
  • sem_permissaoA chave de API não pode fazer isso. Veja o motivo em "detalhe".
  • ja_e_membroEsse e-mail já é de alguém da equipe.
  • limite_de_acessosO plano chegou ao limite de acessos (pessoas + convites abertos). Remova alguém ou cancele um convite.
  • limite_de_convitesLimite de convites: 20 por dia por organização e 3 por dia para o mesmo e-mail. Tente amanhã.
  • membro_inexistentePessoa não encontrada nesta organização (veja GET /equipe/membros).
  • convite_inexistenteConvite não encontrado, já aceito ou vencido (veja GET /equipe/convites).
  • equipe_inexistenteEquipe não encontrada (veja GET /equipe/equipes).
  • equipe_repetidaJá existe uma equipe com esse nome.
  • papel_inexistentePapel de acesso não encontrado nesta organização.
  • modulos_do_papelCom papel de acesso, os módulos e a agenda vêm do papel. Mande papel_de_acesso_id: null para escolher à mão.
  • modulo_invalidoMódulo inválido. Use conversas, contatos, automacoes, agentes, funil, agenda, followup ou relatorios.
  • conversa_inexistenteConversa não encontrada.

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