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

# Configurar o Greenhouse

> Configure a troca de dados entre a CloudTalk e o Greenhouse para garantir que os seus dados estão sempre atualizados.

<Note>
  Este guia vai ajudá-lo a conectar o Greenhouse à CloudTalk em apenas alguns passos simples.
</Note>

**Nível de utilizador**: Admin

***

<h2 id="h_ed0a52d297">
  Antes de começar
</h2>

Antes de configurar a integração do Greenhouse, certifique-se de que tem o seguinte pronto:

* **Uma conta Greenhouse** com acesso ao Dev Center e ao API Credential Management.

* **Uma chave de API Harvest do Greenhouse** com as seguintes permissões ativadas: `GET: Retrieve Candidate`, `GET: List Candidates`, `POST: Add Note` e `GET: List Users`. Pode gerar esta chave no Greenhouse em **Dev Center > API Credentials**.

* **O seu subdomínio do Greenhouse**, que é a primeira parte do seu URL do Greenhouse. Por exemplo, se o seu URL for `yourcompany.greenhouse.io`, o seu subdomínio é `yourcompany`.

* **O endereço de email que utiliza na CloudTalk tem de corresponder exatamente ao endereço de email da sua conta Greenhouse**. Se os endereços de email não corresponderem, a sincronização não funcionará corretamente.

<h2 id="h_7b71dcb5f5">
  Configurar o Greenhouse
</h2>

1. No seu CloudTalk Dashboard, navegue até **Conta > Integrações**

2. Encontre o **Greenhouse** e clique em **+ Adicionar**

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/Ql3WX5wAKbGZniqk/images/help-center/articles/11937842/816abe4c8cee-screenshot-2025-08-05-at-11-28-19.png?fit=max&auto=format&n=Ql3WX5wAKbGZniqk&q=85&s=0358c837ab8eca54ddbebc937eb14509" alt="" width="200" data-path="images/help-center/articles/11937842/816abe4c8cee-screenshot-2025-08-05-at-11-28-19.png" />
   </Frame>

3. Ser-lhe-á pedido que forneça o seguinte:

   * **O seu nome de autenticação**

   * **Chave de API**

   * **Subdomínio do Greenhouse**

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/Ql3WX5wAKbGZniqk/images/help-center/articles/11937842/db671a70a6a3-screenshot-2025-08-05-at-11-36-37.png?fit=max&auto=format&n=Ql3WX5wAKbGZniqk&q=85&s=e727111e6038419a7a39b5f293474787" alt="" width="2183" height="868" data-path="images/help-center/articles/11937842/db671a70a6a3-screenshot-2025-08-05-at-11-36-37.png" />
   </Frame>

4\. Depois de preencher os detalhes, clique em **Enviar**.

***

<h3 id="h_7818bc17c3">
  Onde encontrar as suas credenciais
</h3>

<h4 id="h_3bb49feb87">
  Chave de API
</h4>

Para gerar uma chave de API no Greenhouse:

1. Aceda a **Dev Center** > **API Credentials**

2. Clique em **Create new API credentials**

3. Na janela pop-up:

   * Defina **API type** como `Harvest`

   * Defina **Partner** como `Custom`

   * Adicione uma descrição

4. Clique em **Manage permissions** para continuar e copie a chave no ecrã seguinte

<Frame>
  <img src="https://mintcdn.com/cloudtalk/Ql3WX5wAKbGZniqk/images/help-center/articles/11937842/c1af83025914-screenshot-2025-08-05-at-10-53-45.png?fit=max&auto=format&n=Ql3WX5wAKbGZniqk&q=85&s=c7833423dc1b703a65517ece653edc0c" alt="" width="2733" height="1413" data-path="images/help-center/articles/11937842/c1af83025914-screenshot-2025-08-05-at-10-53-45.png" />
</Frame>

<h4 id="h_a38050c94d">
  Permissões da chave de API
</h4>

Ao configurar a integração do Greenhouse, é importante garantir que são aplicadas as permissões corretas à sua chave de API Harvest. Estas permissões não são configuráveis no momento da criação da chave, mas têm de ser editadas posteriormente.

Para atualizar as permissões da chave de API:

1. Aceda a **Greenhouse Settings**.

2. Navegue até **Dev Center > API Credential Management**.

3. Localize a sua **chave de API da CloudTalk** e clique no botão **Edit** ao lado.

4. Na secção **Manage permissions**, certifique-se de que as seguintes permissões estão ativadas:

* `GET: Retrieve Candidate`

* `GET: List Candidates`

* `POST: Add Note`

* `GET: List Users`

Estas permissões são necessárias para permitir que a CloudTalk mostre candidatos, registe a atividade das chamadas e associe notas aos utilizadores corretos no Greenhouse.

<h4 id="h_e9b244a2eb">
  Subdomínio do Greenhouse
</h4>

Esta é a primeira parte do seu URL do Greenhouse.

Exemplo:

```
yourcompany.greenhouse.io → Subdomain = yourcompany
```

***

<h2 id="h_928507506f">
  Personalizar a integração
</h2>

Depois de enviar as credenciais:

1. Altere o estado da integração para **Ativo**.

2. Adicione um **Título** para dar um nome à instância da integração.

3. Se necessário, aplique uma **etiqueta de contacto** aos candidatos sincronizados na CloudTalk.

4. Selecione que **Números** devem ser utilizados para chamadas e SMS.

5. Clique em **Guardar** para confirmar.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/Ql3WX5wAKbGZniqk/images/help-center/articles/11937842/4a62b77d349f-screenshot-2025-08-05-at-11-39-02.png?fit=max&auto=format&n=Ql3WX5wAKbGZniqk&q=85&s=c64a5ad5c5d6df0de3eda70ea7b80d2f" alt="" width="2210" height="786" data-path="images/help-center/articles/11937842/4a62b77d349f-screenshot-2025-08-05-at-11-39-02.png" />
</Frame>

<h2 id="h_1a1594d74d">
  Desconectar a integração do Greenhouse
</h2>

Se precisar de remover a integração:

1. Aceda a **Conta > Integrações** no seu CloudTalk Dashboard

2. Localize o **Greenhouse** e clique em **Configurar**

3. Desça até ao fim e clique em **Eliminar integração**

4. Escreva **DELETE** quando lhe for pedido e confirme

A integração será agora removida da CloudTalk.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/Ql3WX5wAKbGZniqk/images/help-center/articles/11937842/1683fba300ba-screenshot-2025-08-05-at-10-50-23.png?fit=max&auto=format&n=Ql3WX5wAKbGZniqk&q=85&s=72e6ddaa54dc41684faaf49e0448f36a" alt="" width="500" data-path="images/help-center/articles/11937842/1683fba300ba-screenshot-2025-08-05-at-10-50-23.png" />
</Frame>

***

*Precisa de ajuda ou tem alguma dúvida?* Contacte-nos através do nosso [portal de suporte](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — estamos aqui para si.


## Related topics

- [Utilizar a CloudTalk com o Greenhouse](/pt/articles/11938372-using-cloudtalk-with-greenhouse.md)
- [Guia de integrações](/pt/articles/10570091-integrations-guide.md)
- [Configurar o Pipedrive](/pt/articles/2843578-configure-pipedrive.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.