# API do FORSI Chat

> API REST do FORSI Chat (WhatsApp, atendimento, funil, agenda, equipe e relatórios). Versão 1.0.0. Gerado do contrato OpenAPI em cada requisição: está sempre igual à API no ar.

- Base: `https://chat.forsi.com.br/api/v1`
- Autenticação: `Authorization: Bearer <chave>` (chave `fcv2_live_...`, criada em Configurações → API e webhooks; nos exemplos, `fcv2_live_EXAMPLE`)
- Documentação completa para IA: https://docs.forsi.com.br/llms-full.txt (a mesma em https://chat.forsi.com.br/api/docs/llm.md)
- Resumo para IA: https://chat.forsi.com.br/api/docs/llm-resumo.md
- Índice (llms.txt): https://docs.forsi.com.br/llms.txt
- OpenAPI 3.1: https://docs.forsi.com.br/openapi.json
- Páginas para pessoas: https://docs.forsi.com.br (cada página tem a versão .md: https://docs.forsi.com.br/comecando.md)

## 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.

---

Página: https://docs.forsi.com.br · Índice: https://docs.forsi.com.br/llms.txt · Tudo num arquivo: https://docs.forsi.com.br/llms-full.txt