# FORSI Chat API

> API REST do FORSI Chat, plataforma brasileira de atendimento por WhatsApp e Instagram para empresas. Envia mensagens de WhatsApp, lê conversas e contatos, cuida do funil, da agenda e da equipe, automatiza comentários do Instagram, puxa relatórios e manda eventos por webhook assinado.

Base `https://chat.forsi.com.br/api/v1`. Autenticação por chave (`Authorization: Bearer fcv2_live_...`), só no servidor. Respostas em JSON (`{"dados": ...}` ou `{"erro": {...}}`). Cada página da documentação tem uma versão em Markdown: acrescente `.md` ao endereço.

## Comece aqui

- [Começando](https://docs.forsi.com.br/comecando.md): Primeira chamada em 3 passos.
- [Autenticação e chaves](https://docs.forsi.com.br/autenticacao.md): Bearer, escopos, validade, IPs e troca de chave.
- [Webhooks de saída e assinatura](https://docs.forsi.com.br/webhooks.md): Eventos, tentativas, assinatura HMAC e gestão dos webhooks.
- [Erros](https://docs.forsi.com.br/erros.md): Formato único, status HTTP e todos os códigos.

## Conceitos

- [Limites de uso](https://docs.forsi.com.br/limites.md): Requisições por minuto, tamanho e cabeçalhos de limite.
- [Paginação](https://docs.forsi.com.br/paginacao.md): Listas com cursor.
- [Idempotência](https://docs.forsi.com.br/idempotencia.md): Repetir com segurança com Idempotency-Key.
- [Escopos e planos](https://docs.forsi.com.br/escopos.md): O que cada escopo libera e o que o plano precisa ter.
- [Boas práticas de segurança](https://docs.forsi.com.br/seguranca.md): Como guardar chaves e receber webhooks com segurança.

## Guias

- [Seguir para receber](https://docs.forsi.com.br/seguir-para-receber.md): Entregue um conteúdo no direct só para quem segue o seu perfil do Instagram.

## Referência da API

- [Conta](https://docs.forsi.com.br/api/conta.md): A organização, a chave usada e as caixas conectadas, numa chamada só.
- [Webhooks](https://docs.forsi.com.br/api/webhooks.md): Cadastrar, editar, testar, trocar o segredo e ver as entregas dos webhooks.
- [Mensagens](https://docs.forsi.com.br/api/mensagens.md): Enviar texto, mídia e modelos; ver status.
- [Conversas](https://docs.forsi.com.br/api/conversas.md): Listar conversas e ler mensagens.
- [Contatos](https://docs.forsi.com.br/api/contatos.md): Criar, buscar, editar e apagar contatos.
- [Modelos](https://docs.forsi.com.br/api/modelos.md): Modelos aprovados do WhatsApp.
- [Funil e negócios](https://docs.forsi.com.br/api/funil.md): Funis, etapas, negócios e notas.
- [Agenda](https://docs.forsi.com.br/api/agenda.md): Agendas, horários livres, compromissos e bloqueios.
- [Equipe e permissões](https://docs.forsi.com.br/api/equipe.md): Pessoas, convites, equipes e atribuição de conversas.
- [Automações do Instagram](https://docs.forsi.com.br/api/automacoes.md): Regras de comentário: palavra-chave, resposta pública e mensagem direta.
- [Relatórios](https://docs.forsi.com.br/api/relatorios.md): Volume, tempo de resposta, equipe, caixas, IA e créditos.

## Optional

- [Documentação completa num arquivo](https://docs.forsi.com.br/llms-full.txt): todos os guias e endpoints com exemplos
- [Resumo para IA](https://chat.forsi.com.br/api/docs/llm-resumo.md): o essencial e a lista de endpoints, curto
- [OpenAPI 3.1](https://docs.forsi.com.br/openapi.json): o contrato formal, legível por máquina
- [Changelog](https://docs.forsi.com.br/changelog.md): O que mudou em cada versão.