Configuração

Métodos de Configuração

O Workstation oferece duas formas flexíveis de configurar webhooks, cada uma otimizada para diferentes casos de uso:

Interface Visual
API Dinâmica

Configuração Permanente via Interface

Ideal para: Integrações de longo prazo, ambientes de produção, múltiplas equipesConfigure seus webhooks visualmente através da interface do Workstation em poucos cliques e receba os eventos automaticamente:

Interface intuitiva: Configure tudo visualmente sem escrever código
Gestão centralizada: Veja e gerencie todas as suas integrações em um só lugar
Headers fixos: Configure tokens de autenticação e headers que serão enviados automaticamente
Teste integrado: Botão de teste permite validar sua configuração antes de ativar

Como Configurar

Acesse as configurações

Acesse as configurações do app no Workstation

Navegue até Events

Acesse a aba “Events”

Habilite Eventos

Habilite os Eventos no app

Preencha os detalhes

URL: Seu endpoint que receberá as notificações
Headers: Adicione headers customizados

Teste

Clique em “Testar Requisição” para validar sua configuração

Salve

Salve e comece a receber notificações!

Webhooks Dinâmicos via API

Ideal para: Integrações SaaS multi-tenant, endpoints dinâmicos, integrações temporáriasEnvie notificações para endpoints diferentes a cada chamada, sem criar subscrições permanentes:

Flexibilidade total: Cada chamada pode notificar um endpoint diferente
Zero configuração prévia: Comece a usar imediatamente sem setup
Headers dinâmicos: Passe credenciais diferentes para cada cliente/contexto
Multi-tenant nativo: Perfeito para SaaS com múltiplos clientes
Webhooks temporários: Útil para testes, demos ou integrações pontuais

Como Usar

Simplesmente adicione webhook_url ao body da sua requisição API e use headers x-tela-forward-* para autenticação:

curl -X POST https://api.tela.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "x-tela-forward-authorization: Bearer token-cliente-123" \
  -H "x-tela-forward-custom-id: request-xyz" \
  -d '{
    "webhook_url": "https://exemplo.com/webhook",
    "prompt": "Analise este documento",
    "files": []
  }'

Quando a task finalizar, o webhook será enviado para https://exemplo.com/webhook com:

Header authorization: Bearer token-cliente-123
Header custom-id: request-xyz

Próximos Passos

Autenticação

Aprenda sobre headers customizados

Referência de Payload

Entenda o payload do webhook

Primeiros passos

Guias

Apps

Configurações

Recursos

Configuração

Métodos de Configuração

Configuração Permanente via Interface

Como Configurar

Webhooks Dinâmicos via API

Como Usar

Próximos Passos

Autenticação

Referência de Payload

Primeiros passos

Guias

Apps

Configurações

Recursos

Documentation Index

​Métodos de Configuração

​Configuração Permanente via Interface

​Como Configurar

​Webhooks Dinâmicos via API

​Como Usar

​Próximos Passos

Autenticação

Referência de Payload

Métodos de Configuração

Configuração Permanente via Interface

Como Configurar

Webhooks Dinâmicos via API

Como Usar

Próximos Passos