Para consultar el catálogo exhaustivo derivado del esquema, consulta todos los ejemplos.
Qué es
Gestiona eventos de eliminación de contactos.Antes de comenzar
- Crea un endpoint HTTPS público en tu aplicación.
- Configura un endpoint de webhook de YCloud para los tipos de eventos que necesitas.
- Almacena el secreto de firma del endpoint de forma segura.
- Haz que el procesamiento de eventos sea idempotente.
Cómo funciona
YCloud envía una solicitud HTTPPOST cuando ocurre el evento. Verifica la firma, registra el evento de forma duradera, devuelve una respuesta 2xx y procesa el trabajo lento de forma asíncrona.
Solicitud
Los siguientes escenarios muestran solicitudes entregadas a la URL de tu webhook. Trata elid del evento como el identificador de entrega y utiliza type para enrutar la carga útil.
Respuesta
Devuelve un estado2xx tras aceptar el evento.
Para la configuración del endpoint, la validación de firmas y el comportamiento de reintentos, consulta Configurar webhooks.
- La URL del endpoint de webhook debe ser proporcionada por tu servidor en lugar de YCloud. Asegúrate de reemplazar la URL con la URL real de tu endpoint de webhook.
- Asegúrate de que tu endpoint de webhook esté escuchando los tipos de eventos apropiados. Consulta también Configurar Webhooks, Obtener una API de endpoint de webhook.
Ejemplo básico de contacto eliminado
Solicitud
Respuesta
Confirma la entrega tras aceptar el evento de forma duradera.Explicación
- Información mínima: El objeto
contactDeletedsolo contiene información esencial:id,nickName,phoneNumberyupdateTime. - Valores nulos: El campo
nickNamepuede sernullsi el contacto no tenía configurado un apodo. - Hora de actualización:
updateTimerefleja cuándo se modificó el contacto por última vez antes de su eliminación. - ID de contacto: El campo
idcontiene el identificador único del contacto eliminado para su referencia. - Número de teléfono: El
phoneNumbersiempre está presente y formateado en formato E.164.

