Usar los eventos de API en marketing saliente
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.
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