> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.ada.cx/docs/handoffs/microsoft-dynamics-365/llms.txt. # Microsoft Dynamics 365 handoff The Microsoft Dynamics 365 integration lets an AI Agent create a support case in Dynamics 365 from a conversation. In Dynamics 365, tickets are called Cases (the underlying record is an incident), and each Case is linked to a Contact. Both are visible in the Customer Service Hub. To sync published Dynamics 365 knowledge articles into your AI Agent, see [Knowledge integrations](/docs/knowledge/content-ingestion/knowledge-integration). The Knowledge integration is set up separately and uses its own Azure app registration. ## Limitations Review the following constraints before planning a Dynamics 365 handoff: * **Case creation only.** The integration creates a Case. Agent replies, Case status changes, and Case closure in Dynamics 365 are not relayed back to the conversation. * **No file attachments.** Files an end user sends in the conversation are not attached to the Case. * **Contact matching uses a single field.** The Contact is matched on email address if one is provided, otherwise on mobile phone number, never both. If the email address matches nothing, a new Contact is created even when the phone number would have matched an existing record. If several Contacts share an email address, the first one Dynamics 365 returns is used. * **Phone numbers must match exactly.** Spaces, dashes, brackets, and dots are removed before searching, but a leading `+` is kept. A Contact stored as `(555) 123-4567` does not match a search for `+15551234567`. * **Custom fields can be dropped without an error.** Only text, yes/no, whole number, and decimal fields are supported. Lookup, Choice, Date and Time, and Currency values are dropped, as are unknown field names and values that do not fit the field type. In every case the Case is still created. ## Capabilities When the AI Agent runs the **Create Ticket** action, the integration: 1. Searches Dynamics 365 for a Contact whose email address matches, if an email address is provided. 2. Searches by mobile phone number instead, if no email address is provided but a phone number is. 3. Creates a new Contact if no match is found, or if neither an email address nor a phone number is provided. 4. Creates a Case linked to that Contact. 5. Returns the incident ID, ticket number, and Contact ID to the AI Agent, so the Agent can confirm the Case number to the end user. ## Get started Unless otherwise noted, all instructions must be followed each time you connect a new AI Agent. To set up the Microsoft Dynamics 365 integration, complete the steps in this order: 1. [Initial configuration](/docs/handoffs/microsoft-dynamics-365/initial-configuration): register an application in Microsoft Entra ID, create an Application User in Dynamics 365, and share the credentials with your Ada team. 2. [Configure the handoff](/docs/handoffs/microsoft-dynamics-365/configure-the-handoff): connect the app in your AI Agent, add the **Create Ticket** block to your handoff, and test it. --- Have any questions? Contact your Ada team, or email us at [](mailto:help@ada.cx?subject=Help%20Docs%20inquiry). ## Docs - [Initial Microsoft Dynamics 365 configuration](https://docs.ada.cx/docs/handoffs/microsoft-dynamics-365/initial-configuration.md) - [Configure the Microsoft Dynamics 365 handoff](https://docs.ada.cx/docs/handoffs/microsoft-dynamics-365/configure-the-handoff.md)