Saltar al contenido principal
Los webhooks embebidos avisan a tu servidor cuando ocurre actividad para cualquier usuario final de tu proyecto de socio. Cada carga identifica al usuario final afectado para que puedas dirigirla al cliente correcto.

Crear una suscripción

Los endpoints de webhook deben usar HTTPS y ser accesibles públicamente.
Omite events, o pasa un arreglo vacío, para recibir todos los eventos reconocidos que ocurran para tus usuarios finales embebidos.
Estos son eventos útiles para una integración de publicación embebida:

Verificar la firma

Social media studio firma con HMAC-SHA256 el cuerpo HTTP exacto y sin procesar de la solicitud. Lee el cuerpo como texto o bytes y verifícalo antes de analizar el JSON.
La firma puede enviarse como un resumen hexadecimal o con el prefijo v1=; el SDK acepta ambas formas.

Estructura de la carga

Las solicitudes de entrega también incluyen:

Comportamiento de la entrega

  • Devuelve una respuesta 2xx en cuanto el evento se haya aceptado de forma duradera.
  • Procesa los eventos de forma asíncrona cuando el trabajo pueda tardar más de unos segundos.
  • Deduplica las entregas usando el id de la carga o X-Webhook-Delivery-Id.
  • Las respuestas distintas de 2xx, los fallos de red y los tiempos de espera agotados se reintentan con espera exponencial.
  • Las suscripciones que fallan repetidamente se deshabilitan automáticamente.
La entrega de webhooks es de al menos una vez, así que los manejadores deben ser idempotentes.