> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://helpdesk.closum.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Closum X Salesforce: Integração

# Detalhes Técnicos: Visão Geral

Este artigo descreve os detalhes técnicos da integração entre o Salesforce e o Closum, incluindo os objetos suportados, o mapeamento de campos, o sentido da sincronização e a frequência de atualização.


# Objetos Suportados

A integração permite trabalhar com os seguintes objetos do Salesforce:

###### Objeto - Descrição: 
     
* **Lead** Contacto potencial (prospect)   
* **Contact** Contacto  
* **Account** Conta / empresa   
* **Opportunity** Oportunidade de negócio   
* **Record** Registo genérico:  permite trabalhar com qualquer objeto, incluindo objetos customizados do Salesforce   
* **Objetos adicionais:** Na configuração da ligação, é possível especificar objetos adicionais (*Additional Objects*); como "Order", "Deal" ou "Order Status" para acompanhar ou atualizar de acordo com as necessidades específicas do negócio.

# Mapeamento de Campos

Não existe uma lista fixa de campos predefinidos. O mapeamento é feito manualmente durante a criação da automação:

1. Ao configurar uma automação, o utilizador escolhe os campos do Salesforce que quer sincronizar.
2. Esses campos são depois mapeados para os campos correspondentes na aplicação de destino (ex: Gmail, Slack, entre outras).
3. Este processo garante que os dados fluem corretamente entre os sistemas, campo a campo.

# Sentido da Sincronização


| A integração funciona nos dois sentidos:

###### Salesforce → Outras Aplicações (Triggers / Gatilhos)

Eventos no Salesforce que podem iniciar uma automação noutra aplicação:

* Novo registo criado
* Registo atualizado
* Registo eliminado
* Nova Lead
* Nova Account
* Nova Opportunity
* Novo Contact
* Opportunity atualizada
* Outbound Message

###### Outras Aplicações → Salesforce (Actions / Ações): 

Ações que podem ser executadas no Salesforce a partir de outra aplicação:

* Criar / atualizar / eliminar registo
* Criar / atualizar Contact
* Criar / atualizar Opportunity
* Criar / atualizar Account
* Criar / atualizar Lead
* Aprovar / rejeitar registo
* Submeter registo para aprovação
* Pesquisar utilizador, contacto, lead, account ou opportunity
* Pedido de API customizado (Custom API Request)

# Frequência de Sincronização

* A integração é apresentada como oferecendo **atualizações em tempo real** entre o Salesforce e as restantes aplicações ligadas.
* Na prática, para chamadas via API (polling), a **frequência por defeito é de 5 em 5 minutos,** ou seja, o Closum verifica automaticamente novos registos ou atualizações no Salesforce a cada 5 minutos, salvo configuração diferente.

# Como Configurar

1. Aceder à secção **Apps** no Closum e adicionar uma nova ligação ao Salesforce.
2. Preencher os campos de ligação: nome, objetos adicionais e ambiente (**Production** ou **Sandbox**).
3. Conceder acesso à conta Salesforce.
4. Selecionar a conta Salesforce pretendida.
5. Ir à secção **Automations**, escolher o Salesforce como app de origem e configurar o trigger, a app de destino e o mapeamento dos campos.
6. Rever, testar e ativar a automação.


||| Se a ligação ao Salesforce expirar, o token de acesso pode ser atualizado através da opção Refresh Token nas definições da ligação. Para dúvidas adicionais sobre esta integração, contacte o suporte.