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

# Configuração

> Aprenda a configurar webhooks via interface ou API

## Métodos de Configuração

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

<Tabs>
  <Tab title="Interface Visual">
    ### Configuração Permanente via Interface

    **Ideal para**: Integrações de longo prazo, ambientes de produção, múltiplas equipes

    Configure 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

    <Frame>
      <video controls autoplay loop muted playsinline width="100%" aria-label="Como configurar eventos de webhook na Workstation">
        <source src="https://mintcdn.com/meistrari/pblu7JGV78zF0-_0/images/guides/workstation/webhook-events.mp4?fit=max&auto=format&n=pblu7JGV78zF0-_0&q=85&s=7acb76fd3dfce139c0255ae77c7c0262" type="video/mp4" data-path="images/guides/workstation/webhook-events.mp4" />

        Seu navegador não suporta vídeos HTML5.
      </video>
    </Frame>

    <Steps>
      <Step title="Acesse as configurações">
        Acesse as configurações do app no Workstation
      </Step>

      <Step title="Navegue até Events">
        Acesse a aba "Events"
      </Step>

      <Step title="Habilite Eventos">
        Habilite os Eventos no app
      </Step>

      <Step title="Preencha os detalhes">
        * **URL**: Seu endpoint que receberá as notificações
        * **Headers**: Adicione headers customizados
      </Step>

      <Step title="Teste">
        Clique em "Testar Requisição" para validar sua configuração
      </Step>

      <Step title="Salve">
        Salve e comece a receber notificações!
      </Step>
    </Steps>
  </Tab>

  <Tab title="API Dinâmica">
    ### Webhooks Dinâmicos via API

    **Ideal para**: Integrações SaaS multi-tenant, endpoints dinâmicos, integrações temporárias

    Envie 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:

    ```bash theme={null}
    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`
  </Tab>
</Tabs>

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Autenticação" icon="key" href="/pt/workstation/events/authentication">
    Aprenda sobre headers customizados
  </Card>

  <Card title="Referência de Payload" icon="file-code" href="/pt/workstation/events/payload-reference">
    Entenda o payload do webhook
  </Card>
</CardGroup>