Plantillas de webhook

Las plantillas de webhook son solicitudes webhook reutilizables - URL, método, cabeceras, autenticación y cuerpo, guardados una vez y usados en cualquier campaña de webhook o paso de journey. Una típica es "Enviar MMS con Delivyr": cada journey que la necesita reutiliza la misma solicitud en lugar de volver a escribirla. Están en Brand Studio → Webhook Templates (/brand/webhook-templates). Ver la biblioteca requiere templates:read; crear y editar requieren templates:write.

Qué contiene una plantilla de webhook

La solicitud completa que envía el paso de webhook: la URL, el método HTTP, cabeceras personalizadas, autenticación (ninguna, token bearer, basic, cabecera de clave API o firma HMAC) y el cuerpo - JSON con marcadores Liquid como {{user.phone}}, o campos codificados como formulario. El editor es el mismo formulario que el paso de webhook de la campaña, incluido Enviar una prueba contra un contacto de muestra. La prueba usa el contacto que elijas - un contacto real se procesa exactamente como en un envío real - y el resultado alterna entre Respuesta recibida y Solicitud enviada: el método, la URL, los encabezados y el cuerpo exactos que se enviaron, con las credenciales ocultas.

Secretos

Los tokens, contraseñas, claves API y secretos de firma se cifran al guardar la plantilla y nunca vuelven a mostrarse: un secreto guardado aparece como un campo enmascarado. Deja el campo enmascarado como está para conservar el secreto, bórralo para eliminarlo o escribe un valor nuevo para reemplazarlo. Un envío de prueba nunca transmite un valor enmascarado; vuelve a introducir el secreto si quieres probarlo.

Cuando una campaña o un journey se crea a partir de una plantilla, Joryio copia el secreto guardado de la plantilla en la copia en el servidor, de modo que el mensaje lleva la credencial sin que el secreto pase nunca por tu navegador.

Usar una plantilla

• Campañas - en el paso de redacción del webhook, un mensaje nuevo se abre con dos opciones: Crear la solicitud o Usar una plantilla de webhook. Elige una plantilla por nombre (las más recientes primero) y se copia en el mensaje.
• Journeys - un nodo de mensaje webhook, y el bloque Webhook independiente, tienen un buscador Empezar desde plantilla en la parte superior de la pestaña de solicitud.

La campaña o el journey es dueño de la copia. Editarla, o editar la plantilla después, nunca afecta a la otra. Eliminar una plantilla es seguro: las copias existentes siguen funcionando.

Gestionar plantillas

La biblioteca muestra cada plantilla con su método y URL, quién la creó y la editó por última vez, y cuándo. Las filas ofrecen Editar, Duplicar y Eliminar; seleccionar filas abre una eliminación masiva. La búsqueda coincide con nombre, descripción y URL; el filtro de etiquetas acota por etiqueta.