> ## 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 HubSpot
> Configure a troca de dados entre a CloudTalk e o HubSpot para garantir que os seus dados se mantêm atualizados.
Este artigo explica como ligar o HubSpot à CloudTalk, configurar as definições de sincronização e compreender como os dados são mapeados entre os dois sistemas.
**Nível de utilizador:** Admin
***
Antes de começar
* Tem de ser Admin na CloudTalk.
* Tem de ter permissão para instalar aplicações no HubSpot.
* O endereço de email que utiliza na CloudTalk tem de corresponder exatamente ao endereço de email da sua conta HubSpot. Se os emails não coincidirem, a sincronização não funcionará corretamente.
* Os agentes da CloudTalk têm de ter o mesmo endereço de email que o respetivo utilizador do HubSpot.
* Quando liga o HubSpot pela primeira vez, a CloudTalk importa os seus deals e tickets juntamente com os contactos. Os registos importados não podem ser removidos em massa mais tarde.
Ligar o HubSpot à CloudTalk
1. A partir do seu [Dashboard](https://dashboard.cloudtalk.io), aceda a **Conta** > **Integrações**.
2. Na lista de integrações, passe o cursor sobre **HubSpot** e selecione **`+ Adicionar`**.
3. Será reencaminhado para o início de sessão do HubSpot, onde deve introduzir as suas credenciais.
4. Se tiver várias contas HubSpot, ser-lhe-á pedido que escolha aquela que pretende integrar com a CloudTalk.
5. **Connect app** para conceder as permissões e continuar.
6. Após a autenticação ser concluída com êxito, será reencaminhado para o Dashboard da CloudTalk, onde pode personalizar a integração.
7. Clique em **Guardar** para aplicar estas alterações e ativar a integração.
1. *Pode definir a integração como Inativa a qualquer momento através do interruptor no topo.*
Assim que a integração estiver configurada, todos os seus contactos do HubSpot serão sincronizados com a CloudTalk. Quando o **proprietário de um contacto muda no HubSpot**, a CloudTalk atualiza o **Agente favorito** do contacto em conformidade (desde que esse utilizador exista como agente na CloudTalk).
As [Automações de fluxo de trabalho](/pt/articles/5450779-configuring-workflow-automations) da CloudTalk funcionam apenas com a **integração HubSpot criada mais recentemente**. Mesmo que configure várias integrações HubSpot, as alterações na estrutura de autenticação do HubSpot fazem com que apenas a integração mais recente funcione com as automações de fluxo de trabalho.
Personalização da integração
* **Escolha que chamadas serão registadas no HubSpot**. Pode definir que chamadas *(chamadas recebidas, chamadas de saída, chamadas não atendidas e mensagens de correio de voz)* registar no HubSpot. A chamada será registada como um engagement do HubSpot.
* Selecione se a CloudTalk deve criar uma atividade de chamada no HubSpot **quando a chamada é atendida** ou **quando a chamada termina**. Pode escolher quando a CloudTalk deve criar uma atividade de chamada no HubSpot:
* **Respondido**: será criada uma atividade de chamada no HubSpot assim que a chamada for atendida.
* **Terminado**: a atividade de chamada só será criada depois de a chamada terminar (comportamento predefinido).
Esta definição dá-lhe flexibilidade: por exemplo, se a sua equipa quiser ver as chamadas a aparecer no HubSpot de imediato ou acionar workflows do HubSpot assim que uma chamada começa, utilize a opção **Respondido**.
* **Opte por associar apenas a atividade de determinados números** à sua integração HubSpot através da secção *Connected numbers*. Se esta secção ficar vazia, serão sincronizados os dados associados a todos os números da empresa.
* Decida se pretende **registar todas as chamadas** ou **apenas as chamadas feitas durante o horário de funcionamento** e onde atribuir as **chamadas não atendidas.** Personalize a forma como **são criados novos contactos para números não associados**.
* **Escolha como as atividades de chamada e de SMS são associadas às empresas do HubSpot** através da definição **Estratégia para registar chamadas nas empresas do HubSpot**. Isto controla se as atividades de chamada (e de SMS) são também registadas nos registos de empresa associados ao contacto correspondente:
* **Não registar numa empresa**: a atividade é registada apenas no contacto, no deal e no ticket (tal como antes desta funcionalidade).
* **Registar na empresa principal**: a atividade é também registada na empresa principal do contacto no HubSpot.
* **Registar em todas as empresas**: a atividade é registada em todas as empresas associadas ao contacto no momento da exportação.
As **novas integrações** têm como predefinição *Registar na empresa principal*. As **integrações existentes** têm como predefinição *Não registar numa empresa*; o comportamento mantém-se inalterado a menos que altere esta definição. As mesmas opções estão disponíveis para SMS em **Definições de fluxo de trabalho para SMS**.
⚠️ Esta definição aplica-se apenas às atividades exportadas depois de ser configurada. As chamadas e SMS anteriores não são associadas retroativamente aos registos de empresa.
* Reproduza gravações de chamadas e veja as transcrições diretamente no HubSpot como **call engagements**.
* Especifique uma **tag** para os seus contactos do HubSpot na CloudTalk e **importe casos** do HubSpot como atividades de contacto.
- Ative o registo de chamadas do **VoiceAgent** e escolha o utilizador a atribuir às chamadas do VoiceAgent registadas. Estas chamadas aparecem no HubSpot com a etiqueta “Voice Agent Call”.
Mapeamento de resultados
A CloudTalk pode preencher o campo **HubSpot Activity Outcome** de três formas diferentes, consoante a sua configuração.
Disposição por tipo de chamada
Nas **Definições do fluxo de trabalho**, pode definir um resultado predefinido para cada tipo de chamada através da\
opção "disposição de \ como".
Isto permite-lhe atribuir um HubSpot Activity Outcome específico a:
* Chamadas recebidas
* Chamadas de saída
* Chamadas não atendidas
* Mensagens de correio de voz
Esta definição funciona como lógica de contingência se não se aplicar nenhum outro mapeamento de resultados.
Mapeamento de resultados baseado em tags
Na secção **Mapeamento de resultados**, pode mapear as tags de chamada da CloudTalk para HubSpot Activity Outcomes específicos.
Quando é aplicada a uma chamada uma tag mapeada, é utilizado o resultado correspondente do HubSpot.
Se forem aplicadas várias tags mapeadas à mesma chamada, a primeira que surge na tabela Mapeamento de resultados determina o resultado. Pode arrastar e largar os resultados para os reordenar.
Também pode configurar um resultado predefinido a utilizar quando não existe nenhuma tag mapeada.
Mapeamento de disposições de campanha
Quando utiliza o Campaign Dialer da CloudTalk, pode mapear as disposições de campanha para HubSpot Activity Outcomes através da coluna **Mapeamento de Integração** em **[Configurações de Disposição](/pt/articles/9562215-using-hubspot-with-campaign-dialers#:~:text=PM%20each%20day.-,Disposition%20Mapping%20to%20HubSpot%20Outcomes,-%E2%9A%A0%EF%B8%8F%20Important%3A)**.
Se uma disposição de campanha estiver mapeada para um resultado do HubSpot, é esse o valor utilizado para a chamada.
Lógica de prioridade dos resultados
Se se aplicarem várias configurações à mesma chamada, o HubSpot Activity Outcome é determinado pela seguinte ordem de prioridade:
1. **Mapeamento de disposições de campanha** (prioridade mais alta)
2. **Mapeamento de resultados baseado em tags**
3. **Definição de tipo de chamada no fluxo de trabalho** (contingência)
De onde vêm os resultados de chamada do HubSpot
A CloudTalk obtém os resultados de chamada do HubSpot a partir das definições internas de Calling do HubSpot. Estes resultados provêm do campo de sistema `hs_call_disposition`, que o HubSpot utiliza para guardar os resultados de chamadas e de reuniões.
Apenas os resultados criados nas definições Calling Outcome do HubSpot podem aparecer na CloudTalk. Criar “Call Outcomes” como uma propriedade personalizada do CRM não funciona, uma vez que a CloudTalk não lê resultados a partir de propriedades personalizadas.
O HubSpot permite que os clientes giram os resultados de chamada diretamente nas definições Calling. Os resultados de chamada personalizados têm de ser criados na interface do HubSpot.
Para mais informações, consulte o [guia do HubSpot sobre a criação de resultados de chamada personalizados](https://knowledge.hubspot.com/calling/create-custom-call-and-meeting-outcomes).
**Fazer chamadas a partir do HubSpot**
Siga o [guia de CTI do HubSpot](https://knowledge.hubspot.com/calling/integrate-a-third-party-calling-provider-with-hubspot) para configurar a CloudTalk como o seu telefone principal no HubSpot e consulte os nossos guias sobre [como utilizar o CTI do HubSpot](/pt/articles/5368689-cloudtalk-phone-in-hubspot) e [soluções rápidas](/pt/articles/8272721-hubspot-quick-fixes).
Sincronização de dados e mapeamento de campos
Mapeamento de novos contactos
\* = campo obrigatório
| **Contacto da CloudTalk** | **Direção da sincronização** | **Contacto do HubSpot** |
| - | - | - |
| Nome completo\* (o nome próprio é apenas a 1.ª palavra) | ⬅➡ | First name\* e Last name\* |
| Número(s) de telefone\* (apenas o 1.º e o 2.º número) | ⬅➡ | Phone number (número principal e número de telemóvel) |
| Email\* (apenas o 1.º endereço de email) | ⬅➡ | Email\* (apenas o email principal) |
| Empresa | ➡ | Company name (não uma empresa associada do HubSpot) |
| Morada | ➡ | Street address |
| Cidade | ➡ | City |
| Código postal | ➡ | Postal code |
| Estado | ➡ | State/region |
| Agente favorito | ⬅ | Contact owner (apenas endereços de email de agentes existentes na CloudTalk) |
| Tags (ao nível do contacto) | 🚫 | Não sincronizadas como propriedades de contacto |
| Campos personalizados | 🚫 | Não sincronizados |
Atualizar um contacto no HubSpot
\* = campo obrigatório
| Contacto da CloudTalk | Atualizado | Contacto do HubSpot |
| - | - | - |
| Nome completo\* (o nome próprio é apenas a 1.ª palavra) | ⬅ | First name\* e Last name\* |
| Telefone\* (adiciona outro número e mantém os números antigos) | ⬅ | Phone number (números principal e de telemóvel) |
| Email (adiciona outro endereço de email e mantém os endereços antigos) | ⬅ | Email\* (apenas o endereço de email principal) |
| Empresa | 🚫 | Company name ou Company associada |
| Morada | 🚫 | Street address |
| Cidade | 🚫 | City |
| Código postal | 🚫 | Postal code |
| Estado | 🚫 | State/region |
| Agente favorito | ⬅ | Contact owner |
| Tags (ao nível do contacto) | 🚫 | Não sincronizadas |
| Campos personalizados | 🚫 | Não sincronizados |
***
💡 *Pretende desativar a sincronização de contactos da CloudTalk para o HubSpot?* A nossa equipa de engenharia pode ajustar esta definição no backend por si. Como não existe nenhum botão nas definições da aplicação, basta enviar um pedido à nossa [equipa de Suporte](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) para desativar as exportações de atualizações de contactos
Atualizar um contacto na CloudTalk
\* = campo obrigatório
| **Contacto da CloudTalk** | **Atualizado** | **Contacto do HubSpot** |
| - | - | - |
| Nome completo\* (o nome próprio é apenas a 1.ª palavra) | ➡ | First name\* e Last name\* |
| Telefone\* (editar a 1.ª opção atualiza o número principal) | ➡ | Phone number (números principal e de telemóvel) |
| Email (editar a 1.ª opção atualiza o endereço de email principal) | ➡ | Email\* (apenas o endereço de email principal) |
| Empresa | ➡ | Company (não uma empresa associada do HubSpot) |
| Morada | ➡ | Street address |
| Cidade | ➡ | City |
| Código postal | ➡ | Postal code |
| Estado | ➡ | State/region |
| Agente favorito | 🚫 | Contact owner |
| Tags (ao nível do contacto) | 🚫 | Não sincronizadas |
| Campos personalizados | 🚫 | Não sincronizados |
⚠️ Se um contacto da CloudTalk não tiver nome e for associado a um contacto do HubSpot através do número de telefone, uma sincronização pode apagar o nome no HubSpot. Para evitar isto, certifique-se de que os seus contactos da CloudTalk têm nomes guardados ou contacte o [Suporte](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) para desativar as atualizações de contactos da CloudTalk para o HubSpot.
Evitar a perda de dados de campos personalizados com a sincronização do HubSpot e as automações
Quando a **sincronização de contactos recebidos do HubSpot** está ativada, utilizar as Automações de fluxo de trabalho da CloudTalk para atualizar propriedades de contacto pode apagar inadvertidamente os campos personalizados que só existem na CloudTalk.
**Como ocorre a substituição**
1. Uma **[Automação de fluxo de trabalho](/pt/articles/10568412-workflow-automations-guide)** (ou uma ferramenta externa como o Zapier/n8n) edita um contacto na CloudTalk.
2. A CloudTalk emite um evento `contact edited`.
3. A integração do HubSpot deteta o evento e força uma nova sincronização do contacto utilizando a **versão do HubSpot** do contacto.
4. Como o HubSpot não acompanha os campos personalizados que só existem na CloudTalk, substitui esses campos na CloudTalk por valores vazios.
*Nota: editar manualmente um contacto na CloudTalk não desencadeia este ciclo de sincronização.*
**Ações recomendadas**
* **Audite as automações:** remova das suas Automações de fluxo de trabalho da CloudTalk as ações de edição de contactos desnecessárias ou ajuste os triggers para evitar atualizações de contactos.
* **Reveja as ferramentas externas:** tenha cuidado ao utilizar o Zapier ou o n8n para preencher campos que só existem na CloudTalk se, logo a seguir, uma automação da CloudTalk editar o mesmo contacto.
* **Contactar o suporte:** [Contacte o Suporte da CloudTalk](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) para rever a sua configuração ou ajustes de sincronização no backend.
⚠️ Este comportamento está associado a um problema de engenharia conhecido. Se os campos personalizados estiverem a desaparecer em grande escala na sua conta, **suspenda imediatamente as automações afetadas** e contacte o Suporte para evitar mais perdas de dados.
Desligar a integração do HubSpot
Caso decida deixar de utilizar o HubSpot com a CloudTalk, pode seguir estes passos para desligar a integração.
1. Inicie sessão no seu [Dashboard](https://dashboard.cloudtalk.io/) e aceda a **Conta > Integrações** no menu da esquerda.
2. Esta página mostra as suas integrações atuais. Junto à integração do HubSpot, selecione **`Alterar`**.
3. Desloque-se para baixo e selecione **Eliminar integração**.
4. Para confirmar, escreva `DELETE` e selecione **Eliminar.**
Depois de concluir estes passos, a integração será eliminada do Dashboard da CloudTalk. Há passos adicionais a seguir para [remover a CloudTalk no HubSpot](https://knowledge.hubspot.com/integrations/connect-apps-to-hubspot#uninstall-an-app).
**Aviso:** Desligar e desinstalar a CloudTalk impede a partilha de informação, como os dados das chamadas, de e para o HubSpot, o que afetará ainda quaisquer contas HubSpot associadas e os respetivos dados.
***
*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 si.
## Related topics
- [Configurar o Help Desk do HubSpot](/pt/articles/16900799-configure-hubspot-help-desk.md)
- [Utilizar a CloudTalk com a HubSpot](/pt/articles/14136029-using-cloudtalk-with-hubspot.md)
- [Workflows de SMS do HubSpot](/pt/articles/6118552-hubspot-sms-workflows.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.