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

# Exemplos de Webhook de Atualização do Ciclo de Vida de Grupos do WhatsApp

> Processe resultados de criação e exclusão de grupos do WhatsApp.

<Note>Para o catálogo completo derivado do esquema, consulte [todos os exemplos](/pt/api-reference/guides/examples/webhook-examples/webhook-payload-examples).</Note>

## O que é

Processe resultados de criação e exclusão de grupos do WhatsApp.

## Antes de começar

* Crie um endpoint HTTPS público na sua aplicação.
* Configure um endpoint de webhook da YCloud para os tipos de evento necessários.
* Armazene o segredo de assinatura do endpoint com segurança.
* Torne o processamento de eventos idempotente.

## Como funciona

A YCloud envia uma requisição HTTP `POST` quando o evento ocorre. Verifique a assinatura, registre o evento de forma durável, retorne uma resposta `2xx` e processe tarefas lentas de forma assíncrona.

## Requisição

Os cenários abaixo mostram requisições entregues ao seu URL de webhook. Trate o `id` do evento como o identificador de entrega e use `type` para rotear o payload.

## Resposta

Retorne um status `2xx` após aceitar o evento.

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
```

<Note>Para configuração do endpoint, validação de assinatura e comportamento de repetição, consulte [Configurar webhooks](/pt/api-reference/guides/api-fundamentals/configure-webhooks).</Note>

<br />

## Grupo criado

Quando um grupo do WhatsApp for criado com sucesso, você receberá um webhook com a seguinte estrutura de payload:

### Requisição

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "evt_group_lifecycle_123",
  "type": "whatsapp.group.lifecycle_update",
  "apiVersion": "v2",
  "createTime": "2026-05-13T00:00:00.000Z",
  "whatsappGroup": {
    "wabaId": "123456789012345",
    "displayPhoneNumber": "16315551111",
    "phoneNumberId": "1234567890123456",
    "field": "group_lifecycle_update",
    "type": "group_create",
    "requestId": "REQ_1",
    "status": "created",
    "groupId": "Y2FwaV9ncm91cDpFWEFNUExFX0dST1VQX0lE",
    "inviteLink": "https://chat.whatsapp.com/AbCdEfGhIjK",
    "subject": "New Purchase Inquiry",
    "description": "Group for purchase inquiries.",
    "joinApprovalMode": "auto_approve",
    "webhookTime": "2026-05-13T00:00:00.000Z",
    "dedupeKey": "123456789012345|REQ_1|group_lifecycle_update|group_create|created"
  }
}
```

### Resposta

Confirme o recebimento após aceitar o evento de forma durável.

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
```

### Explicação

Roteie o evento por `type`, remova duplicatas por `id` e transfira tarefas lentas ou propensas a falhas para um processador assíncrono.

## Grupo excluído

Quando um grupo do WhatsApp for excluído, você receberá um webhook com a seguinte estrutura de payload:

### Requisição

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "evt_group_lifecycle_124",
  "type": "whatsapp.group.lifecycle_update",
  "apiVersion": "v2",
  "createTime": "2026-05-13T00:00:00.000Z",
  "whatsappGroup": {
    "wabaId": "123456789012345",
    "field": "group_lifecycle_update",
    "type": "group_delete",
    "requestId": "REQ_DELETE",
    "status": "deleted",
    "groupId": "Y2FwaV9ncm91cDpFWEFNUExFX0dST1VQX0lE",
    "webhookTime": "2026-05-13T00:00:00.000Z"
  }
}
```

### Resposta

Confirme o recebimento após aceitar o evento de forma durável.

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
```

### Explicação

* **type**: Sempre `whatsapp.group.lifecycle_update` para eventos de ciclo de vida de grupo
* **whatsappGroup**: Contém os detalhes do resultado do ciclo de vida do grupo
  * **field**: Sempre `group_lifecycle_update`
  * **type**: A ação do ciclo de vida, como `group_create` ou `group_delete`
  * **requestId**: O ID da requisição retornado pela operação assíncrona da API de grupo
  * **status**: O status normalizado do resultado, como `created`, `deleted` ou `failed`
  * **groupId**: O ID do grupo do WhatsApp
  * **inviteLink**: O link de convite do grupo, incluído quando a criação do grupo for bem-sucedida
  * **dedupeKey**: Chave de idempotência para desduplicar eventos de webhook de ciclo de vida de grupo

<br />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.