> ## 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.

# Outlook Contacts

> Salve contatos do Wave no Microsoft Outlook, incluindo fotos

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

A integração com Outlook Contacts sincroniza contatos do Wave para o Microsoft Outlook / Microsoft 365 Contacts, incluindo fotos dos contatos. Ela suporta dois modos: **individual** (sua conta pessoal do Outlook) e **organizacional** (uma conexão de administrador que implanta os contatos sincronizados automaticamente no Outlook de todos os membros da equipe).

## Como Conectar

### Individual (Outlook pessoal)

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

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

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

### Organizacional (Outlook de todos os membros da equipe)

<Steps>
  <Step title="Abra a integração como administrador">
    Um administrador acessa **Integrações → Outlook Contacts**.
  </Step>

  <Step title="Conecte com a organização">
    Clique em **Conectar com a organização** e faça login com uma conta de administrador do Azure AD.
  </Step>

  <Step title="Conceda o consentimento de administrador">
    Conceda o consentimento de administrador para que o Wave possa sincronizar contatos no Outlook de todos os membros da equipe.
  </Step>
</Steps>

O Wave solicita acesso offline (para manter a conexão ativa) e acesso de leitura/escrita para criar e atualizar contatos no Outlook.

## O Que É Sincronizado

| Campo no Wave                  | Campo no Outlook                  |
| ------------------------------ | --------------------------------- |
| Nome                           | `givenName`                       |
| Sobrenome                      | `surname`                         |
| Nome de exibição               | `displayName`                     |
| Cargo                          | `jobTitle`                        |
| Empresa                        | `companyName`                     |
| Telefone principal (celular)   | `mobilePhone`                     |
| Telefone(s) comercial(is)      | `businessPhones`                  |
| Outros telefones               | `homePhones`                      |
| Até 3 e-mails                  | `emailAddresses`                  |
| Rua, cidade, estado, CEP, país | `businessAddress`                 |
| Site                           | `businessHomePage`                |
| Nota do contato                | `personalNotes`                   |
| Foto do contato                | Foto do contato no Outlook (JPEG) |

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

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

## Funcionalidades

* **Modo organizacional**: uma única conexão de administrador sincroniza contatos no Outlook de todos os membros elegíveis da equipe (usuários cujo e-mail exista no tenant Azure AD conectado).
* **Fotos dos contatos**: as fotos de perfil são sincronizadas e convertidas para JPEG para compatibilidade com o Outlook.
* **Sincronização automática ao conectar**: importa todos os contatos existentes na primeira conexão usando a API de lote do Microsoft Graph.
* **Deduplicação**: os contatos são identificados por uma propriedade estendida específica do Wave, garantindo que as atualizações nunca criem duplicatas.

## Limitações e Requisitos

* O Outlook limita os contatos a 3 endereços de e-mail. O e-mail principal é sempre listado primeiro.
* No modo organizacional, apenas os usuários cujo e-mail exista no tenant Azure AD conectado recebem os contatos sincronizados.
* O modo organizacional requer o consentimento de administrador do Azure AD.

## Desconectar

Acesse **Integrações → Outlook Contacts** e clique em **Desconectar**. Isso remove a integração. Os contatos já sincronizados no Outlook não são excluídos.