> ## 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 > Explore orientações passo a passo de webhooks específicos por evento, pré-requisitos e exemplos de payload. Para o catálogo completo derivado do schema, consulte [todos os exemplos](/pt/api-reference/guides/examples/webhook-examples/webhook-payload-examples). ## O que é Explore orientações passo a passo de webhooks específicos por evento, pré-requisitos e exemplos de payload. ## 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 de forma segura. * 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 na URL do seu 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 ``` Para configuração de endpoint, validação de assinatura e comportamento de novas tentativas, consulte [Configurar webhooks](/pt/api-reference/guides/api-fundamentals/configure-webhooks). ## Eventos de mensagem e modelo Processe estados de modelo aprovado, rejeitado, pausado, desativado e arquivado. Processe mensagens de saída enviadas, entregues, lidas e com falha. Faça o parse de mensagens de texto, mídia, localização, contato, interativas, comerciais e do sistema. Processe alterações em transações de pagamento do WhatsApp. ## Eventos de eco e transferência de agente Para agentes integrados por meio da API REST pública, use estes passos a passo específicos por evento. Agentes criados pelo Console usam um fluxo separado de sincronização de caixa de entrada. Armazene ecos de texto e mídia enviados. Processe atualizações de status de entregue, lido, envio tardio e com falha. Monitore a transferência de controle e compreenda seus limites de correlação. ## Eventos de conta, aplicativo e Flow Processe alterações de elegibilidade, localização, violação, restrição e estado da conta. Sincronize mensagens históricas recebidas e enviadas. Sincronize mensagens enviadas pelo WhatsApp Business App. Processe alterações no status do ciclo de vida do Flow. ## Eventos de chamadas e grupos Processe ofertas e respostas SDP para chamadas do WhatsApp. Processe estados de chamada chamando, aceita e rejeitada. Processe encerramentos de chamada concluídos e com falha. Processe a criação e exclusão de grupos. Processe alterações de participantes e solicitações de entrada. Processe alterações de assunto e descrição do grupo. Processe a suspensão e o restabelecimento do grupo. ## Eventos de contato Processe contatos recém-criados. Remova ou reconcilie contatos excluídos. Processe alterações de perfil, atributos personalizados e tags. Processe registros de opt-out recém-criados. Processe registros de opt-out excluídos. Explore todos os tipos de evento e todos os exemplos de payload nomeados da especificação OpenAPI. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.