Webhook de Cancelación de Suscripción de Teléfono

POST

Se activa cuando un número de teléfono se da de baja mediante el envío de un formulario

Authorizations

• token

Request Body ^required

Media type application/json

object

id

UUID único de entidad

string

/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/

api_version

Versión de la estructura de datos de notificación

string

name

Nombre del evento de Webhook

string

created_at

Fecha en la que se añadió la entidad al sistema por el usuario

integer

attempt_total

Número total de intentos de entrega de webhooks de notificación

integer

>= 1 <= 4

attempt_number

Número de intento de notificación webhook actual

integer

>= 1

notification_task_id

Notification task identifier (request identifier)

string format: uuid

name

Allowed values: phone.unsubscribe

data

Phone unsubscribe webhook data payload

object

phone

required

Número de teléfono que se dio de baja

string

user_id

required

ID del usuario asociado con el número de teléfono

integer

created_at

required

Unix timestamp when the unsubscribe occurred

integer

campaign_code

required

Código de campaña asociado con la cancelación

string

additional_data

required

object

reason

required

object

id

required

ID de motivo para la cancelación. Valores posibles:

• 1: Nunca me suscribí
• 2: Demasiados mensajes
• 3: No me interesa
• 4: El contenido es incomprensible
• 5: No me gusta su empresa
• 6: Otro motivo

integer

Allowed values: 1 2 3 4 5 6

label

required

Motivo legible para la cancelación

string

additional_text

required

Texto adicional proporcionado por el usuario

string

short_link_code

required

Código de enlace corto asociado con la cancelación

string

unsubscribe_request_id

required

ID de la solicitud de cancelación

integer

group_id

ID del grupo asociado con la cancelación del teléfono

integer

timestamp

Marca de tiempo Unix cuando ocurrió la cancelación

Examples

Example unsubscribe

Evento de cancelación de suscripción de teléfono

{
  "id": "ef58b437-1319-4b0c-961b-17214cf1cf32",
  "data": {
    "phone": "+4911113333444",
    "user_id": 2,
    "created_at": 1757849748,
    "campaign_code": "3KCKb5nMD",
    "additional_data": {
      "reason": {
        "id": 4,
        "label": "Es ist unverständlich"
      },
      "additional_text": "zusätzlicher Benutzertext mit Erklärung"
    },
    "short_link_code": "baaIou",
    "unsubscribe_request_id": 59
  },
  "name": "phone.unsubscribe",
  "created_at": 1757849748,
  "api_version": "2022-05-25",
  "attempt_number": 1,
  "attempts_total": 4
}

Responses

200

Webhook recibido

400

Estructura del cuerpo de la solicitud de webhook no válida

401

Solicitud de webhook no autorizada

403

Acceso Webhook prohibido

404

No se ha encontrado el punto final del webhook

500

Error del servidor