Skip to main content
O workspace é o contêiner principal da sua organização no Tivar. Tudo o que você cria e configura — canais conectados, contatos, conversas, membros da equipe, agentes de IA, chaves de API e webhooks — vive dentro de um único workspace. Pense nele como o ambiente de trabalho compartilhado de toda a sua equipe.

​
O que existe dentro de um workspace

Integrações (canais)

Conexões com canais de mensagem como WhatsApp, Telegram, Instagram e outros. Cada integração representa um canal ativo pelo qual você recebe e envia mensagens.

Contatos

Todas as pessoas que interagem com sua equipe, identificadas por número de telefone ou identificador do canal.

Conversas

Os fios de mensagens entre sua equipe (ou agentes de IA) e cada contato, organizados por canal e status.

Membros da equipe

Os usuários humanos que acessam o painel do Tivar e respondem às conversas.

Agentes de IA

Agentes automatizados que podem ser atribuídos a conversas para responder mensagens de forma autônoma.

API Keys e Webhooks

Credenciais para autenticar chamadas de API e URLs de destino para receber eventos em tempo real.

​
Como acessar as configurações do workspace

Todas as configurações ficam em Configurações → Workspace no painel do Tivar. A partir desse menu você pode gerenciar membros, visualizar sua API Key e configurar webhooks outbound.

​
API Key

Sua API Key é o segredo que autentica todas as chamadas à API pública do Tivar. Você a encontra em Configurações → Workspace → API Key.
Trate sua API Key como uma senha. Não a exponha em repositórios públicos nem em código client-side. Se ela for comprometida, gere uma nova imediatamente nas configurações do workspace.
Inclua a chave no header Authorization de todas as requisições: 
Authorization: Bearer sk_live_xxxxx

​
Rate limits

O Tivar aplica um limite de 60 requisições por minuto por workspace para a maioria dos endpoints da API. O endpoint /api/external/messages/send não possui rate limit próprio.
Quando você ultrapassar o limite, a API retorna 429 com a mensagem "Muitas requisições. Limite: 60/min por workspace.". Aguarde o intervalo de um minuto e reenvie a requisição.
A API retorna 401 com "API Key inválida". Verifique se está usando a chave correta em Configurações → Workspace → API Key e se o header Authorization: Bearer <chave> está formatado corretamente.
Seu workspace foi suspenso. Entre em contato com o suporte do Tivar para reativar o ambiente.