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

# Assinar webhooks para uma WABA

> Assinar webhooks para uma WABA. Consulte os parâmetros, o exemplo e as respostas disponíveis para esta operação.



## OpenAPI

````yaml pt/api-reference/meta/openapi.json POST /meta/wabas/{wabaId}/webhook-subscriptions
openapi: 3.1.0
info:
  title: Wrapper da API Meta da Eazybe
  version: 1.0.0
  description: >-
    Uma superfície REST autenticada da Eazybe para a API do WhatsApp Business
    Cloud.
servers:
  - url: https://cerberus.eazybe.com/staging/api/v2
    description: >-
      Substitua este marcador pelo host da API da Eazybe atribuído ao seu
      ambiente.
security:
  - bearerAuth: []
tags:
  - name: Números de telefone
    description: Descubra WABAs e IDs de números de telefone conectados.
  - name: Mensagens
    description: Envie mensagens do WhatsApp e atualize o estado delas.
  - name: Modelos
    description: Gerencie modelos de mensagens do WhatsApp.
  - name: Mídia
    description: Envie, consulte e exclua arquivos de mídia do WhatsApp.
  - name: Webhooks
    description: Gerencie assinaturas de webhook de uma WABA.
  - name: Análises
    description: Consulte análises de mensagens, conversas, preços e modelos.
  - name: Perfis e configurações
    description: Gerencie perfis comerciais e configurações de números de telefone.
  - name: Automação
    description: Configure mensagens de boas-vindas, perguntas iniciais e comandos.
  - name: Códigos QR
    description: Gerencie códigos QR de clique para conversar.
  - name: Flows
    description: Gerencie o ciclo de vida do WhatsApp Flows.
  - name: Administração de números
    description: Registre números, gerencie PINs e sincronize dados de coexistência.
  - name: Lista de bloqueados
    description: Liste, bloqueie e desbloqueie usuários do WhatsApp.
paths:
  /meta/wabas/{wabaId}/webhook-subscriptions:
    parameters:
      - $ref: '#/components/parameters/WabaId'
    post:
      tags:
        - Webhooks
      summary: Assinar webhooks para uma WABA
      description: >-
        Assinar webhooks para uma WABA. Consulte os parâmetros, o exemplo e as
        respostas disponíveis para esta operação.
      operationId: createWebhookSubscription
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - overrideCallbackUri
                - verifyToken
              properties:
                overrideCallbackUri:
                  type: string
                verifyToken:
                  type: string
              description: |-
                ```json
                {
                  "overrideCallbackUri": "https://your-app.com/webhooks/whatsapp",
                  "verifyToken": "shared-secret"
                }
                ```
            example:
              overrideCallbackUri: https://your-app.com/webhooks/whatsapp
              verifyToken: shared-secret
      responses:
        '200':
          description: >-
            App subscribed to this WABA's events


            **Failure responses**


            | **Status** | **Meaning** | **Action** |

            | --- | --- | --- |

            | `401` | Missing, invalid, or expired bearer token |
            Re-authenticate |

            | `404` | `wabaId` not linked to your organization | Verify the id |

            | `400` | Callback URL failed Meta's verification handshake, or is
            not HTTPS | Return `hub.challenge` on the `GET` handshake |

            | `502` | Graph unreachable or timed out | Retry with backoff |
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                properties:
                  success:
                    type: boolean
              example:
                success: true
components:
  parameters:
    WabaId:
      name: wabaId
      in: path
      required: true
      description: >-
        ID da conta do WhatsApp Business retornado por `GET
        /meta/phone-numbers`.
      schema:
        type: string
      example: '1029384756'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Eazybe token
      description: >-
        Token bearer da Eazybe. O token identifica a organização e deve ser
        mantido no servidor.

````