---
title: "Exchange - Configurar um conector de receção"
description: "Coloque uma gateway antispam externa à frente da sua plataforma Exchange OVHcloud com um conector de receção, criado e gerido com a API OVHcloud"
url: https://docs.ovhcloud.com/pt/guides/web-cloud/email-and-collaborative-solutions/microsoft-exchange/feature-receive-connector
lang: pt
lastUpdated: 2026-11-16
---
> For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/pt/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/pt/llms-full.txt.

# Exchange - Configurar um conector de receção

## Objetivo

Um conector de receção indica à sua plataforma Exchange quais os servidores autorizados a entregar-lhe e-mails e em que condições. Serve para colocar uma solução antispam externa, também chamada gateway de filtragem, à frente da sua plataforma Exchange: os registos MX
 do seu nome de domínio apontam para esta gateway, que filtra os e-mails de entrada e, em seguida, os transmite ao Exchange.
O conector de receção está disponível para [Private Exchange](https://www.ovhcloud.com/pt/emails/private-exchange/) e [Trusted Exchange](https://www.ovhcloud.com/pt/enterprise/products/trusted-exchange/). Só pode ser criado e gerido com a API OVHcloud.

**Este guia explica como criar, modificar, desativar e eliminar um conector de receção na sua plataforma Exchange com a API OVHcloud.**

**Nota:** Para fazer passar os e-mails **de saída** da sua plataforma por um servidor externo, utilize antes um conector de envio: consulte o nosso guia "[Exchange - Configurar um conector de envio](https://docs.ovhcloud.com/pt/guides/web-cloud/email-and-collaborative-solutions/microsoft-exchange/feature-send-connector.md)".

## Requisitos

- Dispor de uma plataforma [Private Exchange](https://www.ovhcloud.com/pt/emails/private-exchange/) ou [Trusted Exchange](https://www.ovhcloud.com/pt/enterprise/products/trusted-exchange/).
- Dispor de credenciais API geradas na página de criação de tokens OVHcloud, com, no mínimo, o direito `GET` em `/email/exchange` e os direitos `GET`, `POST`, `PUT`, `PATCH` e `DELETE` em `/email/exchange/*`. Consulte o nosso guia "[Primeiros passos com as API OVHcloud](https://docs.ovhcloud.com/pt/guides/manage-and-operate/api/first-steps.md)".
- Conhecer os endereços IP dos servidores da sua solução antispam externa que vão entregar os e-mails ao Exchange. Peça-os ao prestador desta solução.

## Instruções

### Compreender o conector de receção predefinido

Cada plataforma Exchange dispõe de um conector de receção predefinido. Pertence ao Exchange: não o pode modificar nem eliminar, apenas ativar ou desativar. Na API, a sua propriedade `default` tem o valor `true`.

Enquanto estiver ativado, a sua plataforma aceita todos os e-mails de entrada, seja qual for o servidor que os entrega: um conector de receção que crie não tem, nesse caso, qualquer efeito. Para que apenas a sua gateway possa entregar e-mails ao Exchange, desative manualmente o conector predefinido. Este nunca é desativado automaticamente, para evitar uma interrupção brusca da receção.

**Aviso:** **Desative o conector predefinido em último lugar.** Se nenhum outro conector ativado se aplicar, a sua desativação interrompe a receção de todos os e-mails da plataforma. Antes de o desativar, verifique se o seu conector de receção está ativado e se os registos MX do seu nome de domínio apontam para a sua gateway.

### Encontrar os parâmetros de caminho

As chamadas do conector de receção precisam do nome da organização (`organizationName`) e do nome do serviço (`exchangeService`) da sua plataforma. Obtenha-os por ordem: a primeira chamada abaixo fornece a organização, necessária para a segunda.

**1. Organização** (`organizationName`)

Liste as organizações Exchange da sua conta com a chamada API abaixo:

[GET /email/exchange](https://api.eu.ovhcloud.com/console/?section=/email/exchange&branch=v1#get-/email/exchange)

**2. Serviço** (`exchangeService`)

Liste os serviços Exchange da organização com a chamada API abaixo:

[GET /email/exchange/{organizationName}/service](https://api.eu.ovhcloud.com/console/?section=/email/exchange&branch=v1#get-/email/exchange/-organizationName-/service)

### Criar um conector de receção

Crie o conector com a chamada API abaixo:

[POST /email/exchange/{organizationName}/service/{exchangeService}/receiveConnector](https://api.eu.ovhcloud.com/console/?section=/email/exchange&branch=v1#post-/email/exchange/-organizationName-/service/-exchangeService-/receiveConnector)

Preencha os seguintes campos no corpo do pedido. Apenas `name`, `remoteIpRanges` e `requireTls` são obrigatórios.

| Campo            | Tipo      | Descrição                                                                                      |
| ---------------- | --------- | ---------------------------------------------------------------------------------------------- |
| `name`           | string    | Nome do conector, 255 caracteres no máximo                                                     |
| `remoteIpRanges` | string\[] | Endereços IP dos servidores autorizados a entregar e-mails através deste conector (ver abaixo) |
| `requireTls`     | boolean   | `true` para exigir TLS para todos os e-mails recebidos por este conector                       |
| `maxMessageSize` | long      | Opcional. Tamanho máximo de um e-mail recebido por este conector, em MB                        |
| `enabled`        | boolean   | Opcional. `true` para ativar o conector logo após a sua criação (`false` por predefinição)     |

Cada entrada de `remoteIpRanges` pode ser:

- um único endereço IP, por exemplo `203.0.113.10`;
- uma rede em notação CIDR, por exemplo `203.0.113.0/28`;
- um intervalo de endereços "início-fim", com ambos os limites incluídos, por exemplo `203.0.113.10-203.0.113.20`.

São aceites endereços IPv4 e IPv6.

**Aviso:** **Limites de `remoteIpRanges`**

- Um mesmo endereço IP não pode constar de dois conectores de receção da plataforma.
- A lista completa, depois de unidas as suas entradas por vírgulas, não pode exceder 255 caracteres. Prefira uma rede CIDR a uma longa lista de endereços individuais.

A chamada devolve uma tarefa: o conector é criado quando esta tarefa estiver concluída.

### Listar e consultar os conectores de receção

Liste os conectores de receção da plataforma, incluindo o conector predefinido, com a chamada API abaixo:

[GET /email/exchange/{organizationName}/service/{exchangeService}/receiveConnector](https://api.eu.ovhcloud.com/console/?section=/email/exchange&branch=v1#get-/email/exchange/-organizationName-/service/-exchangeService-/receiveConnector)

A chamada devolve a lista dos identificadores (`id`) dos conectores. Consulte os detalhes de um conector com a chamada API abaixo:

[GET /email/exchange/{organizationName}/service/{exchangeService}/receiveConnector/{id}](https://api.eu.ovhcloud.com/console/?section=/email/exchange&branch=v1#get-/email/exchange/-organizationName-/service/-exchangeService-/receiveConnector/-id-)

Além dos campos de criação, a resposta contém `id`, o identificador do conector, e `default`, que tem o valor `true` para o conector de receção predefinido.

### Modificar um conector de receção

Para modificar um ou vários campos sem alterar os restantes, utilize a chamada API abaixo:

[PATCH /email/exchange/{organizationName}/service/{exchangeService}/receiveConnector/{id}](https://api.eu.ovhcloud.com/console/?section=/email/exchange&branch=v1#patch-/email/exchange/-organizationName-/service/-exchangeService-/receiveConnector/-id-)

Para substituir toda a configuração do conector, preencha todos os campos na chamada API abaixo:

[PUT /email/exchange/{organizationName}/service/{exchangeService}/receiveConnector/{id}](https://api.eu.ovhcloud.com/console/?section=/email/exchange&branch=v1#put-/email/exchange/-organizationName-/service/-exchangeService-/receiveConnector/-id-)

**Nota:** O campo `remoteIpRanges` substitui a lista registada na sua totalidade. Para adicionar um endereço IP, envie novamente a lista completa: os endereços existentes e o novo.

Para ativar ou desativar um conector, modifique o seu campo `enabled`. No conector de receção predefinido, é o único campo que pode modificar: antes de o desativar, consulte a secção "[Compreender o conector de receção predefinido](#compreender-o-conector-de-receção-predefinido)".

Cada modificação devolve uma tarefa: é aplicada quando esta tarefa estiver concluída.

### Eliminar um conector de receção

Elimine um conector com a chamada API abaixo:

[DELETE /email/exchange/{organizationName}/service/{exchangeService}/receiveConnector/{id}](https://api.eu.ovhcloud.com/console/?section=/email/exchange&branch=v1#delete-/email/exchange/-organizationName-/service/-exchangeService-/receiveConnector/-id-)

A chamada devolve uma tarefa: o conector é eliminado quando esta tarefa estiver concluída. Não pode eliminar o conector de receção predefinido.

Se eliminar o último conector que não seja o predefinido, o conector predefinido é reativado automaticamente, para não bloquear a receção dos e-mails. Este comportamento depende do parâmetro `enableDefaultReceiveConnector` da chamada (`true` por predefinição): com `false`, um conector predefinido desativado permanece desativado e a sua plataforma deixa de receber e-mails.

## Quer saber mais?

[Exchange - Configurar um conector de envio](https://docs.ovhcloud.com/pt/guides/web-cloud/email-and-collaborative-solutions/microsoft-exchange/feature-send-connector.md)

[Editar uma zona DNS da OVHcloud](https://docs.ovhcloud.com/pt/guides/web-cloud/domains/dns-zone-edit.md)

[Guias Microsoft Exchange](https://docs.ovhcloud.com/pt/guides/web-cloud/email-and-collaborative-solutions/microsoft-exchange/landing-page-microsoft-exchange.md)

Para serviços especializados (referenciamento, desenvolvimento, etc.), contacte os [parceiros OVHcloud](https://partner.ovhcloud.com/pt/directory/).

Se pretender usufruir de uma assistência na utilização e na configuração das suas soluções OVHcloud, consulte as nossas diferentes [ofertas de suporte](https://www.ovhcloud.com/pt/support-levels/).

Fale com a nossa [comunidade de utilizadores](https://community.ovhcloud.com/).
