Compartir vía

Usar los eventos de API en marketing saliente

  • Artículo

Nota

Dynamics 365 Marketing y Dynamics 365 Customer Insights son ahora Customer Insights - Journeys y Customer Insights - Data. Para obtener más información, consulte Preguntas frecuentes de Dynamics 365 Customer Insights

Los nuevos clientes de Customer Insights - Journeys solo reciben características de recorridos en tiempo real. Para obtener más información, consulte Instalación de recorridos en tiempo real predeterminada.

Importante

Este artículo solo se aplica a marketing saliente, que se eliminará del producto el 30 de junio de 2025. Para evitar interrupciones, realice la transición a viajes en tiempo real antes de esta fecha. Más información: Descripción general de la transición

La API de eventos es método programático para tener acceso a los datos de eventos, las sesiones, los seguimientos de sesiones, los pases, los oradores y los patrocinadores. Además, le permite registrarse en eventos y sesiones.

Nombre del

El acceso a la API se realiza a través del protocolo HTTPS y del punto de conexión de la API que recibe cuando crea un token de aplicación web. Todos los datos se envían y reciben en formato JSON.

Los campos vacíos se incluyen como valores null en lugar de omitirse.

Punto de conexión

Cada cliente tiene su propia dirección URL para punto de conexión. La dirección URL del punto de conexión de la API de eventos se compone de dos partes:

  • El dominio del punto de conexión
  • El subdirectorio

Recibirá el punto de conexión de la raíz después de crear un token para la aplicación web. Puede obtener más información sobre cómo crear un token de aplicación web aquí: Registrar una aplicación web.

Ejemplo de punto de conexión raíz

https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com

El subdirectorio siempre empieza con EvtMgmt/api seguido de la versión API (que se encuentra en la documentación de la API disponible aquí: Documentos de referencia de la API de administración de eventos.

Ejemplo de subdirectorio

EvtMgmt/api/v2.0/

Ejemplo de dirección URL completa del punto de conexión

https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com/EvtMgmt/api/v2.0/

Autenticación

Para usar la API de eventos, debe proporcionar un web application token como parámetro de dirección URL en cada solicitud. El token de aplicación web se usa para controlar las solicitudes de API asociadas a su organización. Vea Registrar una aplicación web para obtener más información sobre cómo crear y recuperar una aplicación web.

El web application token puede agregarse a la solicitud si agrega un parámetro de dirección URL denominado emApplicationtoken.

Ejemplo

https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com/EvtMgmt/api/v2.0/events/published?emApplicationtoken=B7vdzdhCiLt9c5iT….

Además, el origen desde dónde se envía la solicitud debe ser igual que el origen especificado al crear el token de la aplicación web.

Si no proporciona un token de aplicación web o el encabezado de origen, la API de eventos devolverá HTTP 400 Bad Request.

Si el token de aplicación web no es válido, la API de eventos devolverá HTTP 401 Unauthorized.

Registrar su aplicación web

Para usar la API de eventos, debe proporcionar un token de aplicación web en cada solicitud. El token de aplicación web se usa para controlar las solicitudes de API asociadas a su organización. Más información: Registrar su aplicación web