> ## Documentation Index
> Fetch the complete documentation index at: https://wavecnct.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Dynamics 365

> Sincronize contatos do Wave com o Microsoft Dynamics 365 Sales

<Info>
  Disponível nos planos **Pro**, **Teams** e **Enterprise**.
</Info>

A integração com Microsoft Dynamics 365 sincroniza contatos do Wave para o seu ambiente Dynamics 365 Sales (Dataverse) como Contatos. Um campo de identificador externo personalizado é usado para deduplicação, garantindo que os contatos sejam atualizados — nunca duplicados — sempre que sofrerem alterações no Wave.

## Como Conectar

<Steps>
  <Step title="Abra a integração">
    Acesse **Integrações → Microsoft Dynamics 365**.
  </Step>

  <Step title="Insira a URL da sua instância">
    Digite a URL da sua instância do Dynamics 365 (por exemplo, `https://org12345678.crm.dynamics.com`).
  </Step>

  <Step title="Ative a sincronização automática (opcional)">
    Ative a **Sincronização automática** para importar todos os contatos existentes do Wave imediatamente.
  </Step>

  <Step title="Conecte o Dynamics 365">
    Clique em **Conectar** e faça login com sua conta Microsoft.
  </Step>
</Steps>

O Wave solicita permissões de autenticação e atualização de token, além de `user_impersonation` na sua instância do Dynamics para criar e atualizar registros de Contato em seu nome.

## O Que É Sincronizado

| Campo no Wave                | Campo no Dynamics 365                          |
| ---------------------------- | ---------------------------------------------- |
| Nome                         | `firstname`                                    |
| Sobrenome                    | `lastname`                                     |
| E-mail principal             | `emailaddress1`                                |
| Telefone principal           | `mobilephone`                                  |
| Empresa                      | `company` (máx. 49 caracteres)                 |
| Cargo                        | `jobtitle`                                     |
| Site                         | `websiteurl`                                   |
| Nota do contato              | `description`                                  |
| Membro da equipe responsável | `ownerid` (correspondido por e-mail)           |
| ID do contato no Wave        | `externaluseridentifier` (prefixo `wavecnct_`) |

**Direção da sincronização**: Wave → Dynamics 365 (somente de saída)

**Quando sincroniza**: Em tempo real ao criar, atualizar ou excluir um contato

## Funcionalidades

* **Sincronização automática ao conectar**: importa todos os contatos Wave existentes na primeira conexão, processados em lotes.
* **Deduplicação**: os contatos são identificados pelo campo `externaluseridentifier`, evitando duplicatas mesmo quando o mesmo contato é atualizado várias vezes.
* **Atribuição de proprietário**: os contatos são atribuídos ao usuário do sistema Dynamics 365 cujo e-mail corresponde ao do membro da equipe no Wave.

## Limitações e Requisitos

* Você deve fornecer a URL da instância do Dynamics 365 durante a configuração.
* A correspondência de proprietários é feita por e-mail. Se nenhum usuário do sistema correspondente for encontrado, o contato é salvo sem proprietário.
* O nome da empresa é limitado a 49 caracteres pelo Dynamics.
* É necessária uma licença válida do Dynamics 365 Sales e acesso ao Dataverse.

## Desconectar

Acesse **Integrações → Dynamics 365** e clique em **Desconectar**. Isso remove a integração e revoga o acesso do Wave. Os registros já sincronizados com o Dynamics não são excluídos.