> ## 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 Contato Excluído

> Processe eventos de exclusão de contato.

<Note>Para ver 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 eventos de exclusão de contato.

## 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 eventos 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 duradoura, retorne uma resposta `2xx` e processe tarefas lentas de maneira 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 de endpoint, validação de assinatura e comportamento de repetição, consulte [Configurar webhooks](/pt/api-reference/guides/api-fundamentals/configure-webhooks).</Note>

Pré-requisitos

* O URL do endpoint de webhook deve ser fornecido pelo seu servidor, e não pela YCloud. **Certifique-se de substituir o URL pelo URL real do seu endpoint de webhook.**
* **Certifique-se de que o seu endpoint de webhook esteja ouvindo os tipos de eventos apropriados.** Consulte também [Configurar Webhooks](/pt/api-reference/guides/api-fundamentals/configure-webhooks), [API Obter um endpoint de webhook](/api-reference/webhook-endpoints/retrieve-a-webhook-endpoint).

Ocorre quando um contato é excluído. O payload do webhook contém informações mínimas do contato que foi excluído.

## Exemplo Básico de Contato Excluído

### Requisição

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "evt_3456789012",
  "type": "contact.deleted",
  "apiVersion": "v2",
  "createTime": "2024-01-01T12:00:00.000Z",
  "contactDeleted": {
    "id": "1824266594102064128",
    "nickName": "John Doe",
    "phoneNumber": "+16315551111",
    "updateTime": "2024-01-01T12:00:00.000Z"
  }
}
```

### Resposta

Confirme a entrega após aceitar o evento de forma duradoura.

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

### Explicação

* **Informações Mínimas**: O objeto `contactDeleted` contém apenas informações essenciais: `id`, `nickName`, `phoneNumber` e `updateTime`.
* **Valores Nulos**: O campo `nickName` pode ser `null` se o contato não tiver um apelido definido.
* **Horário de Atualização**: O `updateTime` reflete quando o contato foi modificado pela última vez antes da exclusão.
* **ID do Contato**: O campo `id` contém o identificador exclusivo do contato excluído para referência.
* **Número de Telefone**: O `phoneNumber` está sempre presente e formatado no padrão E.164.


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