Webhooks (integraciones de salida)
Avisa a TUS sistemas cuando algo sucede aquí: factura pagada, propuesta aceptada, negocio ganado, solicitud creada y lead creado — entregados por HTTP con firma.
Qué encuentras en esta pantalla
Un retrato de la pantalla, leído de ella misma — cambia cuando la pantalla cambia.
Acciones disponibles
Enviar evento de prueba
La lista muestra
EventoEstadoIntentoCuándo
Campos del registro
DescriçãoPara você reconhecer a integração (ex.: ERP do cliente).
URL de destino*Endpoint HTTPS que receberá o POST com o corpo em JSON.
Ativo
Empieza aquí
Para qué sirve
Integración en tiempo real sin polling: registre una URL suya y elija los eventos. Cuando el evento ocurre, enviamos un POST con el JSON de lo ocurrido.
Webhooks en lista, las entregas arriba
La lista trae cada webhook con la descripción, la URL, los eventos, el secreto enmascarado y si está activo. Arriba están las últimas entregas — evento, estado, código HTTP, intento y cuándo — y el botón Enviar prueba, que pone en cola un ping para todas las suscripciones activas.
Reglas
Seguridad (firma HMAC)
Cada suscripción tiene un secreto (whsec_...). Todo envío va con el header X-Tenka-Signature (HMAC-SHA256 del cuerpo) — valídelo en su servidor antes de confiar en el contenido.
Entrega y reenvío
¿Falló (timeout/5xx)? La cola reenvía con retroceso progresivo. Las últimas entregas aparecen en la pantalla con estado — use el botón Probar para validar su URL.
Eventos disponibles
fatura.paga, proposta.aceita, negocio.ganho, demanda.criada y lead.criado. El catálogo muestra solo lo que realmente dispara — sin promesa vacía.
Secreto y eventos en la ficha
En la ficha, el secreto firma el cuerpo de cada entrega (encabezado X-Tenka-Signature, HMAC): valídelo de su lado para garantizar el origen. En blanco, Tenka genera uno; el botón al lado genera otro. En Eventos, deje "Todos" o elija qué eventos disparan — al menos uno.
Excluir elimina la suscripción
El webhook no va a la papelera: excluir elimina la suscripción, y su sistema deja de recibir eventos en el acto. Para pausar sin perder la configuración, desmarque Activo.
Preguntas frecuentes
Buenas prácticas
Responda 2xx rápido (procese de forma asíncrona en su lado); trate la duplicidad por el id del evento (las entregas pueden repetirse en el reintento).
¿Te resultó útil este artículo?
En el mismo módulo: Plataforma y seguridad38
Pantalla conectada de la ayudaPantalla ancla del diccionario del detalle. No aparece en el menú.Accesos de la plataformaEl registro de cuándo el equipo de soporte de la plataforma accedió a tu cuenta, qué hizo y con qué autorizac…White-spaceVer qué falta vender a quienes ya son clientes, cruzando la cartera instalada con lo que ya tienen clientes p…Ítem de plantillaPantalla ancla del diccionario del detalle (ítems de la plantilla). No aparece en el menú.Assistente fiscalQuatro passos para a nota sair do Tenka: estado, regime, código de segurança (CSC) e certificado A1 — com a r…ExpediciónControla la separación y el despacho de lo vendido. La expedición confirma que la mercancía realmente salió: …Banda del cargoPantalla ancla del diccionario del detalle (bandas del cargo). No aparece en el menú.Blog — conexión WordPressDonde usted conecta el WordPress de su empresa y le enseña a la IA a escribir como usted: línea editorial (so…
Academia Tenka
Conocer la AcademiaRutas de aprendizaje de tu sector, paso a paso, dentro de la plataforma.