> ## 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.

# Referência de Payload

> Estrutura completa do payload do webhook e garantias de entrega

## Estrutura do Payload do Webhook

Cada webhook entrega um **payload completo e estruturado** com todas as informações relevantes da task, eliminando a necessidade de fazer chamadas adicionais à API.

### Exemplo de Payload Completo

```json theme={null}
{
  "id": "unique-webhook-id",
  "event": "task.completed",
  "timestamp": "2025-10-16T12:00:00Z",
  "task": {
    "id": "task-uuid",
    "title": "Análise de Contrato",
    "description": "Revisão de cláusulas contratuais",
    "status": "completed",
    "reference": 1234,
    // ... metadados completos da task
  },
  "inputContent": {
    "files": [
      {
        "filename": "contrato.pdf",
        "content": "conteúdo processado e extraído",
        "type": "application/pdf"
      }
    ]
  },
  "outputContent": "Análise completa com todas as cláusulas identificadas..."
}
```

### Referência de Campos

<ParamField path="id" type="string" required>
  Identificador único da notificação (útil para deduplicação)
</ParamField>

<ParamField path="event" type="string" required>
  Qual evento disparou este webhook. Valores possíveis:

  * `task.completed` - Task finalizada e pronta para revisão
  * `task.approved` - Task aprovada
</ParamField>

<ParamField path="timestamp" type="string" required>
  Momento exato em que o evento ocorreu (formato ISO 8601)
</ParamField>

<ParamField path="task" type="object" required>
  Dados completos da task incluindo:

  * `id` (string) - Identificador único da task
  * `title` (string) - Título da task
  * `description` (string) - Descrição da task
  * `status` (string) - Status atual da task
  * `reference` (number) - Número de referência legível da task
  * Metadados adicionais
</ParamField>

<ParamField path="inputContent" type="object">
  Todo o conteúdo de entrada que foi processado:

  * `files` (array) - Array de arquivos processados com:
    * `filename` (string) - Nome original do arquivo
    * `content` (string) - Conteúdo processado e extraído
    * `type` (string) - Tipo MIME do arquivo
  * Dados de entrada adicionais
</ParamField>

<ParamField path="outputContent" type="string">
  O resultado completo gerado pela task
</ParamField>

## Próximos Passos

<CardGroup cols={3}>
  <Card title="Visão Geral" icon="webhook" href="/pt/workstation/events/overview">
    Conheça Events e webhooks
  </Card>

  <Card title="Configuração" icon="gear" href="/pt/workstation/events/configuration">
    Configure webhooks no seu app
  </Card>

  <Card title="Autenticação" icon="key" href="/pt/workstation/events/authentication">
    Proteja suas integrações webhook
  </Card>
</CardGroup>