# Integração com FreshDesk: veja o que é e como fazer

A integração com o **Freshdesk** permite que os clientes cadastrados no sistema sejam enviados automaticamente para o software de suporte. Essa funcionalidade garante que a base de atendimento esteja sempre sincronizada com os dados de clientes ativos da plataforma.

## Configuração no Portal Freshdesk

Para iniciar o vínculo entre as plataformas, é necessário obter duas informações fundamentais dentro da sua conta Freshdesk: a **API Key (Token)** e o **Domínio (URL)**.

**Como obter a API Key (Token)**


1. Realize o login no seu portal de suporte Freshdesk.
2. Clique na imagem do seu perfil, localizada no canto superior direito da tela.
3. Acesse a página de **Configurações de Perfil**.
4. Localize sua **API Key** no canto direito da página, logo abaixo da seção de troca de senha.

**Como identificar o Domínio (URL)** O domínio é o endereço completo utilizado para acessar seu portal, seguindo o padrão: `https://suaempresa.freshdesk.com/`.

## Configuração no Procedo

Com os dados do Freshdesk em mãos, a parametrização deve ser concluída dentro do sistema Procedo seguindo estas etapas:


1. Acesse o menu de **Integrações** ou o endereço direto `https://app.procedo.com.br/integracao` e clique em **“Novo registro”**.
2. No campo **“Tipo”**, selecione a opção **“Freshdesk”**.
3. Preencha o campo **“Token”** com a API Key e o campo **“URL”** com o domínio obtido anteriormente.
4. **Campos Personalizados (Opcional):** Se houver campos específicos no Freshdesk que você deseja alimentar através da integração, você pode adicioná-los nesta tela, tanto para a empresa quanto para o contato. Informe o nome do campo conforme cadastrado no Freshdesk e o valor padrão a ser enviado.
5. Clique em **“Salvar”** para ativar a comunicação entre os sistemas.

## Regras de Funcionamento e Sincronização

A sincronização de dados ocorre de forma automática, respeitando os seguintes critérios:

* **Critério de Envio:** Apenas clientes cadastrados com a situação **“Ativo”** são enviados para o Freshdesk.
* **Data de Início:** A integração passa a funcionar para novos registros a partir da data de sua configuração.
* **Registros Anteriores:** Clientes que já estavam cadastrados como "Ativo" antes da ativação da integração não serão enviados de forma automática para o suporte.

---

**Documents**

- [Changelog](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/changelog-Zm8YRaLsX2)
- [Comercial e Vendas](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/comercial-e-vendas-mLzQaeyoTV)
- [Configurações Gerais](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/configuracoes-gerais-J7dm490z1m)
- [Gestão de Relacionamento (CRM)](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/gestao-de-relacionamento-crm-74VyXWo680)
- [Integrações](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/integracoes-zJfkJOXdix)
- [Operações e Produtividade](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/operacoes-e-produtividade-k2U2Vd3Fk8)
- [Projetos](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/projetos-jaD6SWGAB9)
- [Relatórios](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/relatorios-uab6Sta2qa)