Skip to main content
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 HTTP POST 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 el id del evento como el identificador de entrega y utiliza type para enrutar la carga útil.

Respuesta

Devuelve un estado 2xx tras aceptar el evento.
Para la configuración del endpoint, la validación de firmas y el comportamiento de reintentos, consulta Configurar webhooks.
Requisitos previos
  • 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.
Ocurre cuando se elimina un contacto. La carga útil del webhook contiene la información mínima del contacto que fue eliminado.

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 contactDeleted solo contiene información esencial: id, nickName, phoneNumber y updateTime.
  • Valores nulos: El campo nickName puede ser null si el contacto no tenía configurado un apodo.
  • Hora de actualización: updateTime refleja cuándo se modificó el contacto por última vez antes de su eliminación.
  • ID de contacto: El campo id contiene el identificador único del contacto eliminado para su referencia.
  • Número de teléfono: El phoneNumber siempre está presente y formateado en formato E.164.