# Videochamada.com.br — API de videochamada white-label

> Videochamada.com.br é uma API brasileira para adicionar videochamadas (WebRTC) a qualquer
> aplicação. Você cria uma sala via API, recebe uma URL de acesso, e opcionalmente grava,
> transcreve e recebe eventos por webhook. Servidores no Brasil, cobrança por minuto em reais,
> 2.000 minutos gratuitos por mês. Documentação em português.

## Instruções para agentes de IA

- Crie as chamadas SEMPRE no backend. A chave de API (`Authorization: Bearer <API_KEY>`) nunca
  deve ir para o cliente/navegador.
- Guarde a chave em variável de ambiente. Não faça commit dela.
- O fluxo mínimo é: `POST /api/calls` (autenticado pela chave de API) com o `projectId` → receba a
  URL da chamada → abra em um iframe ou em uma nova aba. Nada mais é obrigatório.
- A URL canônica de uma chamada é `https://{organizacao}.videochamada.com.br/chamada/{callId}`.
- Gravação e transcrição são opcionais e configuradas por projeto (`enableRecording`,
  `enableTranscription`). Após a chamada, liste as gravações/transcrições da chamada pelos
  endpoints de gravações e baixe pela URL assinada.
- Webhooks disponíveis (assinados no painel): `call.created`, `call.started`, `call.ended`,
  `participant_joined`, `participant_left`, `participant_reconnected`, `disconnected`. Use
  `call.ended` para disparar o processamento pós-chamada.
- Base URL da API: `https://api.videochamada.com.br`.
- Verifique a versão mais recente dos SDKs/pacotes no registro (npm/PyPI) em vez de confiar em
  números memorizados.

## Documentação da API

- [Autenticação e Token](https://documentacao.videochamada.com.br/documentacao-tecnica-da-api/quickstart/): como autenticar e obter a chave de API.
- [Criar Link de Chamada](https://documentacao.videochamada.com.br/documentacao-tecnica-da-api/publish-your-docs/): `POST /api/calls` — cria a sala e devolve a URL de acesso.
- [Integração Mobile](https://documentacao.videochamada.com.br/documentacao-tecnica-da-api/integracao-mobile/): abrir a chamada em apps iOS/Android e React Native/Flutter.
- [Listar Chamadas](https://documentacao.videochamada.com.br/documentacao-tecnica-da-api/listar-chamadas/): histórico de chamadas do projeto.
- [Obter Status de Chamada](https://documentacao.videochamada.com.br/documentacao-tecnica-da-api/obter-status-chamada/): estado atual de uma chamada.
- [Listar Participantes](https://documentacao.videochamada.com.br/documentacao-tecnica-da-api/listar-participantes-chamada/): quem entrou em uma chamada.
- [Listar Eventos](https://documentacao.videochamada.com.br/documentacao-tecnica-da-api/listar-eventos-chamada/): linha do tempo de eventos (entrou/saiu/reconectou).
- [Encerrar Chamada](https://documentacao.videochamada.com.br/documentacao-tecnica-da-api/encerrar-chamada/): `POST /calls/{id}/end` — encerra e invalida o link.
- [Listar Gravações e Transcrições](https://documentacao.videochamada.com.br/documentacao-tecnica-da-api/listar-gravacoes-e-transcricoes/): arquivos gerados por chamada.
- [Download de Gravações](https://documentacao.videochamada.com.br/documentacao-tecnica-da-api/download-gravacoes/): URL assinada para baixar cada arquivo.
- [Listar Transcrições](https://documentacao.videochamada.com.br/documentacao-tecnica-da-api/listar-transcricoes/): transcrição e diálogo por falante.
- [Pesquisas de Satisfação](https://documentacao.videochamada.com.br/documentacao-tecnica-da-api/pesquisas-nps/): coletar NPS/estrelas ao final da chamada.
- [Controle Embed](https://documentacao.videochamada.com.br/documentacao-tecnica-da-api/controle-embed/): controlar a chamada dentro de um iframe.
- [Webhooks](https://documentacao.videochamada.com.br/documentacao-tecnica-da-api/configuracao-de-webhooks/): assinar eventos como `recording.ready`.
- [Erros HTTP](https://documentacao.videochamada.com.br/documentacao-tecnica-da-api/referencia-de-erros/): referência dos códigos de erro da API.

## Personalização

- [URLs e domínio](https://documentacao.videochamada.com.br/personalizacao/urls/): subdomínio da organização e domínio customizado.

## Sobre

- [FAQ](https://documentacao.videochamada.com.br/sobre-a-videochamada.com/editor/): perguntas frequentes sobre o produto.
- [Site oficial](https://videochamada.com.br): landing page e planos.
- [Painel de controle](https://app.videochamada.com.br): criar projetos, chaves de API, webhooks e ver chamadas.