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

# Ativar webhook de conversa finalizada

> Ativar notificações de webhook quando uma conversa de chat termina

Este endpoint ativa as notificações de webhook de conversa finalizada para um assistente, permitindo que você receba atualizações em tempo real quando uma conversa de chat (WhatsApp ou Web Widget) termina. O webhook inclui a transcrição completa, variáveis extraídas e informações do cliente.

### Corpo da Requisição

<ParamField body="assistant_id" type="integer" required>
  O ID do assistente para ativar o webhook de conversa finalizada
</ParamField>

<ParamField body="webhook_url" type="string" required>
  A URL onde as notificações de webhook serão enviadas quando uma conversa terminar
</ParamField>

### Resposta

<ResponseField name="message" type="string">
  Mensagem de sucesso confirmando que o webhook foi ativado
</ResponseField>

<ResponseField name="data" type="array">
  Array vazio (reservado para uso futuro)
</ResponseField>

### Respostas de Erro

<ResponseField name="404 Não Encontrado">
  <Expandable title="Resposta de Erro">
    <ResponseField name="message" type="string">
      Mensagem de erro quando o assistente não é encontrado ou não pertence ao usuário autenticado
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="422 Erro de Validação">
  <Expandable title="Resposta de Erro">
    <ResponseField name="message" type="string">
      Mensagem de erro indicando falha na validação
    </ResponseField>

    <ResponseField name="errors" type="object">
      Erros de validação detalhados para cada campo
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Resposta de Sucesso theme={null}
  {
    "message": "Webhook de conversa finalizada ativado com sucesso",
    "data": []
  }
  ```

  ```json 404 Não Encontrado theme={null}
  {
    "message": "Assistente não encontrado"
  }
  ```

  ```json 422 Erro de Validação theme={null}
  {
    "message": "Os dados fornecidos eram inválidos.",
    "errors": {
      "assistant_id": [
        "O campo ID do assistente é obrigatório."
      ],
      "webhook_url": [
        "O campo URL do webhook é obrigatório."
      ]
    }
  }
  ```
</ResponseExample>