Envía leads a Dynamics 365

Dynamics 365 guarda todo en Dataverse, y un lead del chat se convierte en una fila de ahí. Qué tabla lo eliges tú -- Cliente potencial, Contacto, Cuenta, Oportunidad o una que haya creado tu personalizador -- y las columnas que se ofrecen son las que esa tabla tiene de verdad.

No hay botón de iniciar sesión. Un registro de aplicación en Microsoft Entra guarda las credenciales, y esta ruta las cambia por un token de corta duración en cada llamada.

Qué necesitas

Cuatro valores, y un paso que no es un valor.

• La URL del entorno, la que Dynamics enseña en Configuración, del estilo https://contoso.crm4.dynamics.com.
• El id de directorio (inquilino) y el id de aplicación (cliente) de un registro de aplicación en Entra.
• Un secreto de cliente de ese registro. Entra muestra su valor una sola vez, al crearlo; el id que aparece al lado no es el secreto.

El usuario de aplicación, que es el paso que se salta todo el mundo

Un registro de aplicación por sí solo puede conseguir un token para tu entorno y no hacer nada con él. Dynamics responde 403 a cualquier llamada de una identidad que no conoce, y un 403 que llega dos segundos después de emitir un token se lee exactamente igual que un secreto incorrecto.

Así que: en el centro de administración de Power Platform, abre tu entorno y ve a Configuración, Usuarios y permisos, Usuarios de aplicación, y añade el registro como usuario de aplicación con un rol de seguridad. El rol decide qué puede crear. Un usuario de aplicación no consume licencia.

Producción, sandbox, desarrollo

Cada uno es su propio entorno en su propio host, y un token emitido para uno lo rechaza el otro. Por eso la URL del entorno es un campo y no algo que buscamos: un inquilino puede tener varios, y solo tú sabes para cuál es esta conexión.

Conectar y enrutar

1. En Destinos, conecta Dynamics 365 con los cuatro valores. Verificamos leyendo el nombre de tu organización, así que el visto verde significa que el token funciona y que el usuario de aplicación existe.
2. Elige la tabla. Cliente potencial, Contacto, Cuenta y Oportunidad primero, luego tus tablas personalizadas y después todo lo demás que exponga el entorno.
3. Crea una ruta -- qué leads coge y en qué tabla se convierten.
4. Mapea las columnas. Salen de la definición de la tabla, así que lo que ves es lo que creó tu personalizador, con los nombres que le puso.

Qué se envía

Solo columnas válidas para creación. Un id, una columna calculada o un acumulado no aparecen nunca en el mapeador, porque fallarían con todos los leads.

Los valores se adaptan al tipo de columna. Una columna numérica o de moneda se queda con los dígitos de lo que escribió el visitante. Una columna de sí/no entiende sí, no, true, false, 1 y 0. Una fecha se convierte en una marca de tiempo completa, que es lo que guarda Dataverse.

Un cliente potencial necesita apellido. Dynamics rechaza uno sin él y el rechazo nombra lastname, no la etiqueta que alguien mapeó. Se rellena con lo que traiga el lead cuando el mapeo lo deja fuera, así que una ruta nunca está a una columna de perder todos los leads.

Qué no hace

Las columnas de opciones y las de búsqueda se quedan fuera del mapeador. Una opción quiere uno de sus propios valores y una búsqueda quiere el id de otra fila, y un texto escrito en un chat no es ninguna de las dos cosas. Ofrecerlas y tirarlas al enviar sería peor que no ofrecerlas.

Crea. No actualiza una fila existente y no ejecuta tus reglas de detección de duplicados -- esas se aplican a esta inserción igual que a cualquier otra.

Business Central es otro producto con otra API, y no es a lo que esto se conecta.