- Destino
https://cliente.example/webhooks- HTTP
- 204
- Firma
- Verificada
Entrega de webhook.
Patrón canónico de entrega de webhook para cis-admin, cis-infra, cis-inbox, usaia y servicios internos.
Verlo por niveles
Primero el componente, después la variación de marca y finalmente su uso dentro de una página.
- Destino
https://cliente.example/webhooks- HTTP
- 503
- Próximo intento
- 25 ago 2026 · 18:32 CLT
- Destino
https://cliente.example/webhooks- HTTP
- 204
- Firma
- Verificada
Ver y copiar el código de este render
<section class="ui-sample ui-service" data-webhook-delivery="true"><header><strong>document.signed</strong><span class="badge badge--ok">Entregado</span></header><dl><div><dt>Destino</dt><dd><code>https://cliente.example/webhooks</code></dd></div><div><dt>HTTP</dt><dd>204</dd></div><div><dt>Firma</dt><dd>Verificada</dd></div></dl><button class="btn btn--secondary" type="button">Ver payload</button></section>Variaciones por marca y sitio
Cada cambio visible declara su autoridad; lo que permanece canónico no se vuelve a inventar en el producto.
Compañía de Innovación de Santiago
Autoridad: CONSTITUTION.md + LOGOS-CANONICOS.md- Destino
https://cliente.example/webhooks- HTTP
- 204
- Firma
- Verificada
Cambia en esta marca
- Navegación y contenido propios del servicio
- Acento reservado para acciones y datos
Permanece canónico
- Mark CIS y namebrand de tres líneas
- IBM Plex Sans, foco, espaciado y anatomía
COCHID
Autoridad: core-style/DECISIONES.md M15 y LOGOS-CANONICOS.md- Destino
https://cliente.example/webhooks- HTTP
- 503
- Próximo intento
- 25 ago 2026 · 18:32 CLT
Cambia en esta marca
- Cuadrado azul y namebrand de tres líneas
- Azul COCHID en selección, capas y series
Permanece canónico
- Estructura y semántica comunes
- Fuentes, unidades y alternativa tabular
Comparación histórica recuperable
Compara la propuesta con cortes reales del repositorio. La ausencia de una muestra se declara y nunca se reconstruye de memoria.
- Estado actual
- Entrega de webhook no tiene una implementación vigente demostrada; sus ejemplos son material candidato.
- Cambio propuesto
- Publicar en r19 el contrato de Entrega de webhook para Patrón canónico de entrega de webhook para cis-admin, cis-infra, cis-inbox, usaia y servicios internos.
- Qué ocurre si respondes No
- Entrega de webhook queda fuera de r19 y sus ejemplos siguen sólo como evidencia pendiente de reformulación.
Preparando comparación histórica…
Antes / r19
La comparación convierte una regla abstracta en una diferencia visible y verificable.
- Destino
https://cliente.example/webhooks- HTTP
- 204
- Firma
- Verificada
- Conecta estado, timestamp y fuente al servicio real.
- Explica impacto, recuperación y recibo cuando hay una falla.
- No muestres CONFIRMADO o EN LÍNEA sin señal verificable.
- No expongas secretos, tokens ni trazas con datos personales.
Responsive
La misma anatomía debe conservar lectura, foco y acciones sin cortar contenido ni crear scroll horizontal en la página.
- Destino
https://cliente.example/webhooks- HTTP
- 204
- Firma
- Verificada
- Destino
https://cliente.example/webhooks- HTTP
- 503
- Próximo intento
- 25 ago 2026 · 18:32 CLT
Cobertura
| Dimensión | Contrato |
|---|---|
| Propietario canónico | Sistema de diseño CIS e Infraestructura · core/core-style |
| Consumidores | cis-admin, cis-infra, cis-inbox, usaia y servicios internos |
| Dependencias | API del servicio, recibos verificables |
| Estado | candidato |
Evidencia de adopción
Patrón propuesto. 0 implementaciones observadas en 0 repositorios.
La observación demuestra uso existente; la aceptación canónica sigue dependiendo de esta ficha y de su propietario.
| Dato | Resultado |
|---|---|
| Clasificación | Patrón propuesto |
| Implementaciones | 0 implementaciones observadas |
| Repositorios | Ningún repositorio observado |
| Snapshot | kit/componentes/componentes-observados.json |
Consumidores observados
El inventario conserva repositorio, archivo fuente y criterio de asociación. Observar una implementación no la convierte automáticamente en canónica.
Estados
| Estado requerido |
|---|
| operativo |
| degradado |
| fallido |
| sin datos |
Accesibilidad
- Conserva nombre accesible, orden de lectura y foco visible.
- Funciona a 320 px, con zoom de 200% y texto largo.
- El color nunca es la única señal de estado o acción.
- El contenido esencial permanece disponible sin JavaScript.
Código HTML
Copia el bloque completo; después cambia contenido y destinos, no su anatomía.
<section class="ui-sample ui-service" data-webhook-delivery="true"><header><strong>document.signed</strong><span class="badge badge--ok">Entregado</span></header><dl><div><dt>Destino</dt><dd><code>https://cliente.example/webhooks</code></dd></div><div><dt>HTTP</dt><dd>204</dd></div><div><dt>Firma</dt><dd>Verificada</dd></div></dl><button class="btn btn--secondary" type="button">Ver payload</button></section>Código TAILWIND
Copia el bloque completo; después cambia contenido y destinos, no su anatomía.
<section class="ui-sample ui-service border border-slate-300 bg-white p-4 text-slate-950 grid gap-3" data-webhook-delivery="true"><header class="flex flex-wrap items-center justify-between gap-3"><strong>document.signed</strong><span class="badge badge--ok">Entregado</span></header><dl class="grid gap-2"><div><dt>Destino</dt><dd><code>https://cliente.example/webhooks</code></dd></div><div><dt>HTTP</dt><dd>204</dd></div><div><dt>Firma</dt><dd>Verificada</dd></div></dl><button class="btn btn--secondary border border-slate-950 px-3 py-2 focus-visible:outline-2 focus-visible:outline-offset-2 disabled:cursor-not-allowed" type="button">Ver payload</button></section>Código REACT
Copia el bloque completo; después cambia contenido y destinos, no su anatomía.
import type { MouseEventHandler } from "react";
export interface WebhookDeliveryItem {
/** Nombre del dato (`<dt>`). */
label: string;
value: string;
/** Muestra el valor en `<code>`, para URL o identificadores que se copian tal cual. */
monospace?: boolean;
}
/** Tono de la insignia de estado: `ok` entregado, `warn` reintento en curso, `err` fallido, `neutral` sin tono. */
export type WebhookDeliveryTone = "ok" | "warn" | "err" | "neutral";
export interface WebhookDeliveryProps {
/** Nombre del evento entregado (`document.signed`). */
title?: string;
/** Estado de la entrega: entregado, reintento en curso o fallido; va en una insignia y vacío lo oculta. */
status?: string;
/** Tono de la insignia; sin valor se deduce de `status` («Entregado» → `ok`, «Reintento 2 de 5» → `warn`, «Fallido» → `err`) y si no lo reconoce es `neutral`. */
statusTone?: WebhookDeliveryTone;
/** Datos de la entrega: destino, código HTTP y verificación de la firma; en un reintento, la hora del próximo intento. */
items?: WebhookDeliveryItem[];
/** Texto del botón; según el estado, ver el payload o reintentar. Vacío lo oculta. */
actionLabel?: string;
onAction?: MouseEventHandler<HTMLButtonElement>;
/** Peso del botón: `secondary` para ver el payload, `primary` cuando la entrega falló y reintentar es lo siguiente que hay que hacer. */
actionTone?: "primary" | "secondary";
className?: string;
}
const ITEMS: WebhookDeliveryItem[] = [
{ label: "Destino", value: "https://cliente.example/webhooks", monospace: true },
{ label: "HTTP", value: "204" },
{ label: "Firma", value: "Verificada" },
];
const WEBHOOK_DELIVERY_BADGE: Record<WebhookDeliveryTone, string> = {
ok: "badge badge--ok",
warn: "badge badge--warn",
err: "badge badge--err",
neutral: "badge",
};
const WEBHOOK_DELIVERY_TONES: [string, WebhookDeliveryTone][] = [
["entregado", "ok"],
["reintento", "warn"],
["pendiente", "warn"],
["fallid", "err"],
["falló", "err"],
["rechazad", "err"],
];
function webhookDeliveryTone(status: string, tone?: WebhookDeliveryTone): WebhookDeliveryTone {
const texto = status.toLowerCase();
return tone ?? WEBHOOK_DELIVERY_TONES.find(([clave]) => texto.includes(clave))?.[1] ?? "neutral";
}
/**
* Estado de la entrega de un webhook a un destino externo, con evento, estado, destino, código HTTP, firma y una acción; se usa en paneles de integración para revisar o reintentar envíos.
*
* El estado va en texto dentro de una insignia con tono. Cuando la entrega falla, pasa el intento en `status` («Reintento 2 de 5») y la acción de reintento en `actionLabel`, `onAction` y `actionTone="primary"`.
*
* @example <WebhookDelivery title="document.signed" status="Reintento 2 de 5" items={[{ label: "Destino", value: "https://cliente.example/webhooks", monospace: true }, { label: "HTTP", value: "503" }, { label: "Próximo intento", value: "25 ago 2026 · 18:32 CLT" }]} actionLabel="Reintentar ahora" actionTone="primary" onAction={reintentar} />
*/
export function WebhookDelivery({
title = "document.signed",
status = "Entregado",
statusTone,
items = ITEMS,
actionLabel = "Ver payload",
onAction,
actionTone = "secondary",
className,
}: WebhookDeliveryProps) {
return (
<section className={["ui-service", className].filter(Boolean).join(" ")} data-webhook-delivery>
<header>
<strong>{title}</strong>
{status ? <span className={WEBHOOK_DELIVERY_BADGE[webhookDeliveryTone(status, statusTone)]}>{status}</span> : null}
</header>
{items.length ? (
<dl>
{items.map((item, i) => (
<div key={`${item.label}-${i}`}>
<dt>{item.label}</dt>
<dd>{item.monospace ? <code>{item.value}</code> : item.value}</dd>
</div>
))}
</dl>
) : null}
{actionLabel ? <button className={`btn btn--${actionTone}`} type="button" onClick={onAction}>{actionLabel}</button> : null}
</section>
);
}