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

# Evento de Teste Webhook

> Envia um evento de teste para o webhook especificado

#### Escopo

```bash theme={null}
    write webhooks
```

<Tip>
  * Este endpoint envia uma requisição POST para a URL configurada no webhook com um payload de teste. Use-o para validar se sua integração está recebendo e processando eventos corretamente.
  * É necessário informar o parâmetro `event` na query string para especificar qual tipo de evento deseja testar
  * O evento de teste será registrado no histórico de eventos do webhook
  * Verifique se sua URL responde em até 8 segundos para evitar falhas de entrega
</Tip>

<Note>
  O `event` informado **não precisa ser um dos eventos configurados** neste webhook — qualquer evento válido do [catálogo de eventos](/conceitos/webhooks) pode ser testado, mesmo que o webhook não esteja inscrito nele.
</Note>


## OpenAPI

````yaml POST /public_api/webhook/event_test/{id}/
openapi: 3.0.3
info:
  title: Cakto API
  version: 1.0.0
  description: Documentação da API pública do Cakto.
servers:
  - url: https://api.cakto.com.br
    description: Cakto API
security: []
paths:
  /public_api/webhook/event_test/{id}/:
    post:
      tags:
        - webhook
      description: |-
        API for testing webhook events, inherits from AppTestEventAPI
        and customizes schema generation settings.
      operationId: webhook_event_test_create
      parameters:
        - in: query
          name: event_id
          schema:
            type: string
            enum:
              - boleto_gerado
              - chargeback
              - checkout_abandonment
              - openfinance_nubank_gerado
              - picpay_gerado
              - pix_gerado
              - purchase_approved
              - purchase_refused
              - refund
              - subscription_canceled
              - subscription_created
              - subscription_paused
              - subscription_renewal_refused
              - subscription_renewed
              - subscription_resumed
          description: '`custom_id` do evento a ser testado'
        - in: path
          name: id
          schema:
            type: integer
          description: Id do App Webhook
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookTest200'
              examples:
                Successo:
                  value:
                    detail: Evento reenviado com sucesso
          description: Corpo da resposta status 200
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookTest400'
              examples:
                EventoNãoSuportado:
                  value:
                    detail: Evento inválido
                  summary: Evento Não Suportado
                EventoAusente:
                  value:
                    detail: ID do evento inválido
                  summary: Evento Ausente
          description: Corpo da resposta status 400
        '401':
          description: Request não autenticado devido à ausência ou invalidez do token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthenticatedError'
              examples:
                Token ausente ou inválido:
                  $ref: '#/components/examples/UnauthenticatedErrorExample'
        '422':
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  response:
                    type: string
                    description: Resposta retornada pelo servidor de destino
                  status_code:
                    type: integer
                    description: Código de status HTTP retornado pelo servidor de destino
                required:
                  - detail
                  - response
                  - status_code
              examples:
                EventoNãoProcessado:
                  value:
                    detail: Erro ao enviar evento de teste
                    response: <<Resposta do servidor de destino>>
                    status_code: 500
                  summary: Erro ao processar o evento de teste
                  description: >-
                    Ocorreu um erro ao processar o evento de teste enviado para
                    o webhook.
          description: Corpo da resposta status 422
      security:
        - OAuth Token: []
components:
  schemas:
    WebhookTest200:
      type: object
      properties:
        detail:
          type: string
      required:
        - detail
    WebhookTest400:
      type: object
      properties:
        detail:
          type: string
      required:
        - detail
    UnauthenticatedError:
      type: object
      properties:
        detail:
          type: string
  examples:
    UnauthenticatedErrorExample:
      summary: Token ausente ou inválido
      description: Token ausente ou inválido
      value:
        detail: As credenciais de autenticação não foram fornecidas.
  securitySchemes:
    OAuth Token:
      type: http
      scheme: bearer
      in: header
      name: Authorization
      description: >-
        Token de autenticação do tipo `Bearer {access_token}`, onde
        `{access_token}` é o token obtido no fluxo de
        [autenticação](/authentication).

````