---
title: "Boas-vindas"
description: "O que é o Qomni Agents, o que sua API faz e que regras cada endpoint compartilha, para você escolher por onde começar."
version: "pt-br"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.qomni.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Boas-vindas

Qomni é Agents: agentes de IA que atendem o telefone, ligam para seus
clientes e conversam em tempo real a partir do seu app. Tem um app web para
administrá-los e uma API para colocá-los no seu código. Toda a API segue as
mesmas regras: as mesmas chaves, os mesmos erros e o mesmo modo de
teste. Se você aprende um endpoint, sabe usar todos.

## O que a API faz

| Recurso | O que você faz com ele | Onde |
|---|---|---|
| Chamadas | Um agente liga para um número e informa como terminou | `POST /calls`, `GET /calls` |
| Sessões em tempo real | Seu app abre uma conversa de voz ou texto com um agente, sem expor sua chave | `POST /realtime/sessions` e um WebSocket |
| Contexto da chave | Verifique uma chave e veja em que célula seu workspace vive | `GET /ping` |

A API vive em um único host, `api.qomni.ai`: o caminho começa pelo produto
e depois a versão, `https://api.qomni.ai/agents/v1`. Fala JSON e é
versionada no caminho. Dentro de uma versão só se adicionam campos, nunca se
removem: seu cliente deve ignorar os campos que não conhece.

## O que vale em todos os endpoints

- **Uma chave por modo.** `sk_agents_test_…` para testar,
  `sk_agents_live_…` para produção. Veja [Chaves de API e autenticação](/pt-br/concepts/authentication/).
- **Um único host.** Seu código não escolhe região: a chave carrega a célula e o
  edge roteia. Veja [O edge e as células](/pt-br/concepts/edge/).
- **O mesmo formato de erro.** `code` para o seu código, `message` para
  pessoas, `request_id` para o suporte. Veja [Erros](/pt-br/concepts/errors/).
- **Modo de teste sem consequências.** A mesma API, sem discar nem
  faturar nada. Veja [Modo de teste](/pt-br/concepts/test-mode/).

## Por onde começar

- [Início rápido](/pt-br/get-started/quickstart/) — Verifique uma chave e faça um agente ligar para um número, em cinco minutos.
- [Fale com um agente em tempo real](/pt-br/agents/realtime/) — Crie uma sessão, abra o socket e converse a partir do seu app.
- [Conceitos](/pt-br/concepts/) — As regras que valem para toda a API.
- [Referência da API](/pt-br/agents-api/) — Cada endpoint, campo e erro, gerado a partir do contrato.

Source: https://docs.qomni.ai/pt-br/get-started/index.mdx
