Webhooks
Creado para:
- Administrador
Marketo permite el uso de webhooks para comunicarse con servicios web de terceros. Los webhooks admiten el uso de los verbos HTTP del GET o del POST para insertar o recuperar datos de una dirección URL específica. Para obtener instrucciones detalladas sobre la creación de webhooks en la aplicación y cómo añadirlos a campañas inteligentes, consulte los siguientes artículos:
Cada webhook individual tiene las siguientes propiedades:
- URL: escriba la URL que usa para enviar la solicitud al servicio web.
- Tipo de solicitud: método HTTP.
- Plantilla de carga útil: si desea transmitir información en el cuerpo del POST, escriba la plantilla. Utilice cualquier formato de datos que admita el POST SOAP HTTP, incluidos XML, JSON o. El formato de serialización debe permitir comillas dobles alrededor de las cadenas. Para insertar un token en su plantilla, haga clic en Insertar token. Los tokens de tipo cadena se encierran automáticamente entre comillas dobles.
- Codificación de token de solicitud: si los valores de token incluyen caracteres especiales (como un signo &), indique el formato de su solicitud (JSON o formulario/URL). Debe seleccionarse la codificación correcta para el cuerpo para asegurarse de que el webhook se comunica correctamente con el servicio web.
- Tipo de respuesta: seleccione el formato de la respuesta que recibe del servicio (JSON o XML). Se debe seleccionar el tipo de respuesta correcto para asignar las propiedades de la respuesta a los campos de posible cliente en Marketo
- Encabezados personalizados - A los que se accede a través de Acciones de Webhooks -> Establecer encabezado personalizado, este menú permite agregar cualquier número de pares de clave-valor personalizados como encabezados HTTP.
Se pueden escribir datos en los posibles clientes a partir de las respuestas del servicio web mediante asignaciones de respuestas
Tokens
Todos los campos salientes de un webhook (URL, plantilla y encabezados personalizados) rellenan el contenido de los tokens en el mismo contexto del paso de flujo. Esto significa que los tokens de cliente potencial y de sistema siempre están disponibles, mientras que los tokens de Déclencheur, de campaña y de programa están disponibles en sus respectivos ámbitos. Consulte artículos relacionados con tokens:
Un caso común es cuando un programa o campaña se asigna explícitamente a un recurso de terceros. Se puede establecer un ID en el nivel de programa como My Token y luego pasarlo a la solicitud de webhook como token.
Personalizar encabezado
Los webhooks permiten el uso de cualquier número de campos de encabezado personalizados para ser enviados junto con la solicitud saliente. Se pueden agregar mediante Acciones de webhooks > Establecer encabezado personalizado. Cada encabezado se registra como un par clave-valor simple. Los tokens se pueden utilizar en esta área.
Sugerencias
- El paso de flujo Llamar al webhook solo es válido en campañas de Déclencheur.
- Las actualizaciones a través de asignaciones de respuesta solo se producirán si el servicio web responde con un código de respuesta HTTP 2xx. Otros tipos de códigos no producirán actualizaciones en el registro.
- Puede utilizar servicios web para realizar procesos personalizados de enriquecimiento, validación o normalización de datos desde servicios internos o externos.
- El tiempo de ejecución del webhook está a merced del tiempo de respuesta del servicio que se está utilizando y puede resultar en largos retrasos de ejecución de la campaña. Incluso si un servicio solo tarda 50 ms en ejecutarse, es decir, 1,5 horas cuando se ejecuta 100 000 veces.
- Marketo espera hasta 30 segundos una llamada de servicio determinada antes de finalizar la llamada (también conocido como tiempo de espera agotado).
- Los caracteres incrustados en el campo URL se pasan como escritos; por ejemplo, "&" se envía como "&", "%26" se envía como "%26"
- Si un carácter debe tener codificación porcentual cuando lo recibe el servidor de destinatarios, debe pasarse explícitamente como la cadena que representa ese carácter