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

> Configure a troca de dados entre a CloudTalk e o Freshdesk para garantir que os seus dados se mantêm atualizados.

<Note>
  Este guia explica como ligar o Freshdesk à CloudTalk, configurar a sincronização de dados e ativar chamadas a partir do Freshdesk.
</Note>

**Nível de utilizador:** Admin

***

<Warning>
  Para mais detalhes sobre como as chamadas são registadas e como os dados são sincronizados após a configuração, consulte [Como usar a CloudTalk com o Help Scout](/pt/articles/5368945-using-cloudtalk-with-help-scout).
</Warning>

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

Certifique-se de que os seguintes requisitos estão cumpridos antes de configurar a integração:

* Tem uma conta CloudTalk ativa e acesso à sua conta Freshdesk

* O utilizador que instala a integração deve ter o cargo **Account Administrator** no Freshdesk (utilizadores com apenas o cargo **Administrador** não podem instalar a integração)

* Tem a sua **chave de API do Freshdesk** e o **URL do domínio** prontos (por exemplo, [`https://yourcompany.freshdesk.com`](https://yourcompany.freshdesk.com))

* O endereço de email utilizado na CloudTalk tem de corresponder exatamente ao endereço de email utilizado no Freshdesk, caso contrário a integração não sincronizará corretamente

Para mais detalhes sobre cargos e permissões, consulte o [guia](https://support.freshdesk.com/support/solutions/articles/96909-controlling-agent-access-with-roles) do Freshdesk.

<h2 id="h_1bccf82294">
  Ligar o Freshdesk à CloudTalk
</h2>

<h3 id="h_999c1ff8cc">
  Passos no Freshdesk
</h3>

1. Inicie sessão na sua conta Freshdesk e navegue até **Configurações de Perfil.**

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2582636/084a0e43a2fe-freshdesk-profile-settings-link.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=73c9ea8e0d999184f9d7ce2a3c0a2e77" alt="" width="1000" height="211" data-path="images/help-center/articles/2582636/084a0e43a2fe-freshdesk-profile-settings-link.png" />
   </Frame>

2. Encontre e copie a sua **Chave de API.**

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2582636/2c77f442b783-freshdesk-api-key.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=3446ccf6b26ce68cd27cb5038570bbc9" alt="" width="1000" height="242" data-path="images/help-center/articles/2582636/2c77f442b783-freshdesk-api-key.png" />
   </Frame>

3. Copie o **URL do domínio** da sua conta a partir da barra de endereço. O formato será algo como: [`https://{myaccount}.freshdesk.com`](https://%7Bmyaccount%7D.freshdesk.com).

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2582636/fb7469b1d927-freshdesk-domain-url.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=ef6b0b364893266fc3558dab37e84ae3" alt="" width="1000" height="223" data-path="images/help-center/articles/2582636/fb7469b1d927-freshdesk-domain-url.png" />
   </Frame>

4. Guarde a sua **Chave de API** e o **URL do domínio**. Vai precisar deles para concluir a configuração na CloudTalk.

<h3 id="h_3e7bbe1f00">
  Passos na CloudTalk Dashboard
</h3>

1. No seu [dashboard](https://dashboard.cloudtalk.io), navegue até **Conta** > **Integrações**.

2. Na lista de integrações, passe o cursor sobre **Freshdesk** e selecione **+Adicionar**`.`

3. Introduza a sua **Chave de API do Freshdesk** e o **URL do domínio**, e clique em **Enviar.**

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2582636/30c27caf5e10-image.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=9a9ef3e6ad32ab631b762b8050522060" alt="" width="2834" height="570" data-path="images/help-center/articles/2582636/30c27caf5e10-image.png" />
   </Frame>

4. Após um processo de autenticação bem-sucedido, será redirecionado de volta para as definições de integração, onde pode personalizar a sua integração.

5. **Guardar** para aplicar estas alterações e ativar a integração.

   1. *Pode definir a sua integração como Inativo em qualquer momento, utilizando o interruptor na parte superior.*

Depois de a integração estar configurada, todos os seus contactos do Freshdesk serão sincronizados com a CloudTalk.

<h2 id="h_61b9746ecb">
  Personalização da integração
</h2>

<h3 id="h_bd3d6b5fad">
  Importação de dados
</h3>

Especifique uma tag para os seus contactos do Freshdesk na CloudTalk e escolha se pretende importar os tickets existentes do Freshdesk como atividades de contacto.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2582636/c0e22cd142b1-image.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=f56f237d79b576e122296bae8f12cab5" alt="" width="2836" height="308" data-path="images/help-center/articles/2582636/c0e22cd142b1-image.png" />
</Frame>

<h3 id="h_561436d2b4">
  Registo de chamadas
</h3>

Nas **Definições do fluxo de trabalho** da integração, pode definir quais as chamadas *(chamadas de entrada, chamadas de saída, chamadas perdidas, mensagens de voz e chamadas redirecionadas)* a registar no Freshdesk. As chamadas serão registadas como tickets do Freshdesk.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2582636/88e1c7f3fc4e-image.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=f0a117d6a8d58fa451f2b25078d26565" alt="" width="2832" height="814" data-path="images/help-center/articles/2582636/88e1c7f3fc4e-image.png" />
</Frame>

<h3 id="h_db971bd3bf">
  Atribuição de chamadas perdidas
</h3>

Na definição **Atribuído chamadas perdidas a**, certifique-se de que escolhe um agente ao qual serão atribuídos todos os tickets de chamadas perdidas do Freshdesk. Escolha se pretende criar novos contactos para números não associados.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2582636/434326994a4e-image.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=5acd4981102c2ee71be6763e2f0fcc4b" alt="" width="2840" height="438" data-path="images/help-center/articles/2582636/434326994a4e-image.png" />
</Frame>

**Atribuição de grupo aos tickets de chamada**

Utilize a definição **Atribuir tickets de chamada a um grupo** para controlar qual o grupo do Freshdesk que recebe os tickets criados a partir de exportações de chamadas. Pode encontrar esta definição em **Conta > Integrações > Freshdesk > Definições do fluxo de trabalho**, imediatamente abaixo de **Atribuído chamadas perdidas a**.

A lista pendente mostra os grupos da sua conta Freshdesk associada. Selecione um grupo e todos os tickets de exportação de chamadas serão atribuídos a ele. O agente que atende a chamada é definido como responsável pelo ticket quando pertence ao grupo selecionado.

<Warning>
  **Importante:** o Freshdesk apenas mantém o agente atribuído (responsável) num ticket se esse agente for membro do grupo do ticket. Certifique-se de que o grupo selecionado inclui os seus agentes de chamadas. Caso contrário, o campo do agente no ticket permanecerá vazio, mesmo que a CloudTalk saiba quem atendeu a chamada. Este é um comportamento do Freshdesk, não uma limitação da CloudTalk.
</Warning>

Deixe a definição em **Grupo padrão da conta** para manter o encaminhamento atual do Freshdesk. As contas existentes não são afetadas por esta atualização, a menos que a definição seja alterada. Esta definição aplica-se apenas aos tickets de exportação de chamadas. As chamadas perdidas e as mensagens de voz continuam a ser reguladas pela definição separada **Atribuído chamadas perdidas a** acima.

<h3 id="h_87af53a271">
  Connected Numbers
</h3>

Escolha associar apenas a atividade de determinados números à sua integração com o Freshdesk, utilizando a secção **Connected Numbers**. Se esta secção for deixada em branco, os dados associados a todos os números da empresa serão sincronizados.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2582636/f7e343784771-image.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=085ad59b677d110d0c99e6df76f4adf4" alt="" width="2830" height="252" data-path="images/help-center/articles/2582636/f7e343784771-image.png" />
</Frame>

<h2 id="h_f946487ac9">
  Desativar ou remover a integração
</h2>

Se já não quiser que a CloudTalk sincronize dados com o Freshdesk, pode desativar ou remover definitivamente a integração.

Para **desativar a integração**, vá a **Conta > Integrações**, localize a **integração do Freshdesk** e altere o estado de **Ativo** para **Inativo**.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2582636/db22b14d7694-screenshot-2026-03-23-at-16-04-28.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=6930149069917cf52b38d3bafa49c586" alt="" width="2359" height="322" data-path="images/help-center/articles/2582636/db22b14d7694-screenshot-2026-03-23-at-16-04-28.png" />
</Frame>

Para **eliminar a integração permanentemente**, abra as definições da integração do Freshdesk, percorra a página para baixo, clique em **Eliminar integração** e escreva **Eliminar** para confirmar.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2582636/8aed4aaa4354-screenshot-2b2025-07-03-2bat-2b11-57-50.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=c7a3cd3d773d1f332ab523726560893c" alt="" width="350" data-path="images/help-center/articles/2582636/8aed4aaa4354-screenshot-2b2025-07-03-2bat-2b11-57-50.png" />
</Frame>

***

*Precisa de ajuda ou tem alguma questão?* 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 o ajudar.


## Related topics

- [Utilizar a CloudTalk com o Freshdesk](/pt/articles/14179875-using-cloudtalk-with-freshdesk.md)
- [Acionar uma chamada do VoiceAgent a partir do Freshdesk](/pt/articles/15457387-triggering-a-voiceagent-call-from-freshdesk.md)
- [Guia de integrações](/pt/articles/10570091-integrations-guide.md)


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