Integraciones: webhooks salientes

Configuración → Integraciones (dirección /app/settings/integrations) envía eventos desde este espacio de trabajo a una URL tuya, por ejemplo una herramienta de automatización (Zapier, Make, n8n) o tu propio servidor. Solo Propietario y Administrador pueden verlo y cambiarlo.

Paso a paso: añadir un punto final

1. Abrir Configuración → Integraciones.
2. En URL del endpoint escribe la URL de tu punto final, por ejemplo https://your-system.example.com/omnibrand-hook. Debe ser https y accesible desde internet público; si no, una línea roja indica el motivo ("La dirección del punto final debe empezar por https://. No se acepta http:// simple.", o que no es accesible desde internet).
3. En Eventos marca los eventos que recibe este punto final. Cada casilla tiene una descripción sencilla y el nombre del evento, por ejemplo post.published ("Se publicó una publicación"), post.failed, social_account.token_expired o social_account.disconnected; Todos los eventos, incluidos los que se añadan más adelante es *. workspace.created e invitation.accepted también están. Marca al menos uno, o el formulario dice "Elige al menos un evento."
4. Haz clic en Añadir endpoint.
5. Secreto de firma (copia ahora - se muestra solo una vez): aparece con el secreto, encima del formulario; la página sube hasta él para que también lo veas en un teléfono. Si se rechaza el endpoint, el mensaje rojo aparece en el mismo lugar y la página se desplaza hasta él. Copia el secreto en tu sistema receptor ahora; OmniBrand nunca lo muestra de nuevo (solo sus últimos cuatro caracteres). Copiar secreto junto a él lo copia para ti.
6. Haz clic en Enviar prueba en el endpoint. Ves ✓ entregado con el estado HTTP que ha devuelto tu servidor. Cuando falla, ves "No entregado: tu servidor respondió [estado]." con qué corregir, por ejemplo para 405 Método No Permitido "Debe aceptar solicitudes POST en esta dirección.", para 404 No encontrado "Nada responde en esta dirección. Comprueba la URL.", para un redireccionamiento "Redirigido a otra dirección, y los webhooks nunca siguen a los redirecciones. Registra la última URL en su lugar."; o, cuando no se pudo contactar con el servidor en absoluto, "No entregado: tu servidor no pudo ser contactado ([motivo]). Comprueba la URL y que el servidor está en línea." Un enlace de Cómo funcionan los webhooks abre este artículo.

Cada extremo

• La URL y una insignia activo o desactivado.
• "eventos: ... · secreto ••••1234", con cada evento según su descripción (por ejemplo, "Se publicó una publicación"), más "· N fallos consecutivos" cuando los intentos de entrega fallan y "· N esperando un nuevo intento" mientras los eventos esperan su siguiente intento.
• Una línea roja "N entregas fallidas - abrir historial de entregas para enviarlas de nuevo." cuando los eventos se desistieron (véase Historial de entregas y Reentrega más abajo).
• Habilitado / Desactivado pausa o reanuda las entregas. Mientras el cambio está guardado, la tarjeta dice "Funcionando..." y su Enviar prueba de envío y Eliminar esperan; si el interruptor o Eliminar falla, la razón aparece en rojo en la parte inferior de la tarjeta de ese endpoint, y la página se desplaza hasta ella.
• Enviar prueba envía un evento llamado 'webhook.test' una vez (no se vuelve a intentar ni se guarda en el historial).
• El Historial de entregas abre las entregas recientes del endpoint (el botón Ocultar historial de entregas las cierra).
• Eliminar pregunta "¿Eliminar el webhook a (dirección)? Los eventos dejan de enviarse a él al instante y su secreto de firma desaparece para siempre. Para pausarlo, desactiva su interruptor." La ventana se titula ¿Eliminar el webhook?; haz clic en Eliminar para quitar el punto final al instante, o en Cancelar para conservarlo.

Lo que recibe tu servidor

Un POST con cuerpo JSON: id (el id del evento - úsalo para ignorar duplicados), event (por ejemplo post.published), occurredAt y data (los detalles del evento). Cabeceras:

• X-OmniBrand-Signature: sha256= seguido del HMAC-SHA256 del cuerpo en bruto, marcado con tu secreto de firma.
• X-OmniBrand-Timestamp y X-OmniBrand-Signature-V2: el HMAC-SHA256 de la marca de tiempo, un punto y el cuerpo - lo usan para rechazar repeticiones antiguas.

Responde con cualquier estado 2xx en un plazo de 5 segundos.

Intentos: ¿cuánto tiempo OmniBrand sigue intentándolo

Cada evento se guarda antes de enviarse, así que no se pierde nada si tu servidor —o el nuestro— se reinicia. Cuando tu servidor no responde con un estado 2xx en 5 segundos (un error, un tiempo muerto, una redirección, cualquier respuesta que no sea 2xx), el evento se vuelve a intentar tras aproximadamente 1 minuto, 5 minutos, 15 minutos, 30 minutos, 1 hora, 2 horas, 4 horas, 8 horas y 12 horas - 10 intentos durante unas 28 horas. Cada espera varía hasta un 20%, por lo que no llegan todos los intentos simultáneos. Como un reintento puede llegar después de un evento posterior, usa 'id' para ignorar duplicados y 'occurredAt' para ordenar los eventos.

Si los 10 intentos fallan, la entrega se marca Fallido y permanece en el historial durante 30 días, donde puedes enviarla de nuevo.

Historial de entregas y reentrega

1. En el punto final, haz clic en Historial de entregas. Entregas recientes muestran los últimos 30 días, primero las más recientes.
2. Cada fila muestra una insignia de estado - Entregada, Reintentando o Fallido - el nombre del evento, cuando ocurrió, "Intento N de 10", para Reintentando la vez del "siguiente intento", y para una que no pasó por "Última respuesta:" con lo que tu servidor respondió (por ejemplo, "HTTP 503" o "Sin respuesta en 5 s").
3. Solo fallidas para ver solo los fallidos; Mostrar anteriores . Sin ninguno, dice "No hay entregas fallidas en los últimos 30 días. Las entregas que aún se reintentan no cuentan como fallidas." ( Reintentando aún no ha fallado).
4. Para enviar uno de nuevo, haz clic en Reenviar en su fila. Se envía de inmediato: ves "Entregado." o "Aún no entregado (respuesta). Se intenta de nuevo automáticamente." - un evento reentregado inicia una nueva racha de 10 intentos.
5. Para enviarlos todos de nuevo después de arreglar tu servidor, haz clic en Reenviar todas las fallidas (que se muestra cuando hay entregas fallidas). Ves "N entregas fallidas están en cola y salen en menos de un minuto."

Redeliver necesita activar el endpoint; mientras está Desactivado , los botones esperan y el historial dice "Este endpoint está deshabilitado. Enciende su interruptor para reentregar." Los eventos que llegan mientras un endpoint está deshabilitado no se envían ni se mantienen.

Si algo sale mal

• Las redirecciones nunca se sienten; registra la URL final. Si la tuya redirige, la prueba dice "No entregado: tu servidor respondió 301 Movido permanentemente. Redirigió a otra dirección, y los webhooks nunca siguen las redirecciones. Registra la última URL en su lugar." (con el estado que envió tu servidor).
• Cuando cada intento a un endpoint ha fallado durante todo un día (al menos 20 intentos seguidos), el endpoint se desactivado y se notifica a los administradores. Sus entregas en espera se marcan Fallido. Arregla el receptor, vuelve a poner el interruptor en Habilitado, luego abre el Historial de entregas y haz clic Reenviar todas las fallidas.

Acceso a la API (para desarrolladores)

Al final de la página, la tarjeta Acceso a la API (para desarrolladores): "Conecta OmniBrand con tus propios sistemas, Zapier o Make para crear publicaciones, añadir contactos o leer analíticas automáticamente." En los planes Agencia y Enterprise contiene tus claves para la API pública (consulta Acceso a la API). En los demás planes dice "El acceso a la API está disponible en el plan Agencia." con un enlace Ver planes. Los webhooks de esta página funcionan en todos los planes.

Bueno saberlo

• Un endpoint recibe solo los eventos de este espacio de trabajo, además de eventos a nivel de cuenta (facturación y eventos de cuenta).
• El espacio de trabajo en el que te encuentras cuando añades el endpoint es al que pertenece.