> ## 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 Zendesk
> Configure a troca de dados entre a CloudTalk e o Zendesk para garantir que os seus dados estão sempre atualizados.
Este artigo explica como ligar o Zendesk à CloudTalk, configurar regras avançadas de exportação de chamadas e instalar o CTI da CloudTalk para que a sua equipa possa telefonar diretamente a partir do Zendesk.
**Nível de utilizador**: Admin
***
Precisa de orientação sobre a utilização?\
Consulte o **[Utilizar a CloudTalk com o Zendesk](/pt/articles/5370637-using-cloudtalk-with-zendesk)** guia para saber como as chamadas, os tickets e os contactos se comportam após a configuração.
Veja como funciona
Para ver a integração CloudTalk + Zendesk em ação, veja este breve resumo:
Antes de começar
Certifique-se de que tem o seguinte:
* Uma conta CloudTalk ativa com **acesso de Admin**
* Uma conta Zendesk Support ativa com **permissões de Admin**
* Acesso a **Conta > Integrações** na CloudTalk
* Permissão para instalar aplicações a partir do Zendesk Marketplace
* Permissão para gerir integrações de API no Zendesk
O endereço de email utilizado na CloudTalk tem de corresponder exatamente ao endereço de email utilizado no Zendesk. Caso contrário, a atribuição automática de tickets não funcionará corretamente.
Descrição geral da integração
**Pode configurar a sua integração com o Zendesk de três formas:**
* Apenas a integração/sincronização de dados
* Apenas o CTI
* Ambas (recomendado)
A integração de dados CloudTalk + Zendesk sincroniza todos os dados existentes no Zendesk *(contactos, tickets, emails, etc.)* com a CloudTalk, e vice-versa. Isto permite que os seus agentes tenham uma visão completa dos clientes sem terem de abrir vários sistemas.
A nossa integração de CTI permite que os agentes utilizem o softphone da CloudTalk para fazer e receber chamadas diretamente a partir do Zendesk, poupando tempo e esforço.
Ligar o Zendesk à CloudTalk
1. No Dashboard, vá a **Conta > Integrações** no menu à esquerda.
2. Passe o rato sobre a integração do Zendesk e clique em **`+ Adicionar`**.
3. Introduza o seu **domínio do Zendesk**.
4. Será redirecionado para uma página de início de sessão do Zendesk para aceder à sua conta. Selecione **Authorize** e siga o processo de autorização.
Personalização da integração
Após a autorização ser concluída com sucesso, será redirecionado de volta para o seu dashboard da CloudTalk, onde pode configurar a forma como os dados de chamadas, contactos, tickets, SMS e VoiceAgent são exportados para o Zendesk.
As definições da integração estão divididas nas seguintes secções:
Definições gerais
* **Título**
Personalize o nome desta instância de integração
* **Etiqueta do contacto**
Defina uma etiqueta que será adicionada automaticamente aos contactos sincronizados a partir do Zendesk
* **Sincronizar tickets do Zendesk**
Ative esta opção para ativar a sincronização de tickets entre o Zendesk e a CloudTalk.
Definições de exportação de chamadas
Na secção **Definições de exportação de chamadas**, pode configurar a forma como as chamadas são registadas, atribuídas e enriquecidas no Zendesk.
1. **Escolha quando as chamadas devem ser registadas com base na sua política de Horário de funcionamento.**\
Pode selecionar como a CloudTalk deve tratar as chamadas em relação ao horário de funcionamento configurado. Por exemplo, se escolher **Registar todas as chamadas**, todas as chamadas serão exportadas independentemente da hora.
2. **Criar novos contactos no Zendesk para números de chamada não associados.**\
Quando ativada, a CloudTalk cria automaticamente um novo contacto no Zendesk se for feita ou recebida uma chamada de um número que não existe no Zendesk.
3. **Importar o agente atribuído ao último ticket ativo como agente preferido do contacto.**\
Quando ativada, a CloudTalk atribui o agente do Zendesk do ticket ativo mais recente como agente preferido desse contacto na CloudTalk.
4. **Escolha como os dados das chamadas são exportados como notas internas.**
Pode ativar uma ou mais das seguintes opções:
1. **Exportar toda a chamada como notas internas**\
Quando ativada, todos os detalhes da chamada (notas, metadados, links e gravações) são adicionados como comentários internos no Zendesk.
2. **Exportar apenas a gravação e os links do cliente como notas**\
Quando ativada, apenas a gravação da chamada e o link do contacto na CloudTalk são exportados como notas internas.
3. **Exportar apenas as anotações da chamada como notas internas**\
Quando ativada, apenas as anotações da chamada do agente são exportadas como comentários internos.
As notas internas não são visíveis para os clientes.
5. **Ativar o registo de chamadas do VoiceAgent.**\
Quando ativada, as chamadas do VoiceAgent são exportadas para o Zendesk e etiquetadas em conformidade. Também pode escolher como os tickets do VoiceAgent são atribuídos através do menu pendente **Atribuir chamadas do VoiceAgent a**.
6. **Adicionar a gravação da chamada e a transcrição ao tíquete.**\
Quando ativada, a CloudTalk carrega a gravação da chamada e a transcrição para o ticket do Zendesk como um comentário de voz.
**Importante:** Se uma gravação ou transcrição é exportada depende das suas [Definições do fluxo de trabalho](/pt/articles/5450779-configuring-workflow-automations) de Exportação de Chamadas.\
Se um tipo de chamada estiver configurado para não ser registado (por exemplo, chamadas de saída não atendidas), a respetiva gravação e transcrição **não** serão exportadas.
Regras avançadas de exportação de chamadas
Pode configurar o comportamento de exportação separadamente para cada tipo de chamada. Cada separador permite definir como esse tipo de chamada específico é registado no Zendesk.
Os tipos de chamada incluem **chamadas de entrada atendidas, chamadas de saída atendidas, chamadas não atendidas e correio de voz**.
Definições por tipo de chamada
Comportamento de exportação
Escolha a **Estratégia para registar chamadas em tickets**. Esta definição permite decidir como a CloudTalk deve registar as chamadas nos tickets do Zendesk. Pode escolher entre três opções:
* **Criar novo ticket**: É criado um novo ticket do Zendesk para cada nova chamada efetuada ou recebida na CloudTalk.
* **Adicionar ao último ticket aberto modificado**: A chamada é adicionada como uma nota interna no ticket *Aberta* atualizado mais recentemente associado ao contacto. (Os campos e o estado do ticket não são alterados diretamente, mas as automações do Zendesk podem desencadear outras atualizações.)
* **Não fazer nada**: As chamadas não serão registadas nos tickets do Zendesk.
Isto dá-lhe flexibilidade para controlar se cada chamada cria o seu próprio registo, é agrupada com conversas em curso ou não é registada de todo.
Se a opção *Adicionar ao último ticket aberto modificado* estiver selecionada e não existir nenhum ticket aberto, a CloudTalk cria automaticamente um novo ticket utilizando o tipo, estado, prioridade e definições de atribuição configurados.
Ao registar num ticket existente, as definições de tipo, estado, prioridade e atribuição não se aplicam.
Momento de criação do ticket
Esta opção só está disponível para chamadas **de entrada atendidas** e **de saída atendidas**.
Selecione se a CloudTalk deve criar um ticket do Zendesk quando a chamada é atendida ou quando a chamada termina. Pode escolher entre duas opções:
* **Respondido**: É criado um ticket do Zendesk imediatamente quando a chamada é atendida. Quando a chamada termina, a CloudTalk adiciona uma segunda nota interna que inclui as anotações e etiquetas da chamada.
* **Terminado**: É criado um ticket do Zendesk apenas depois de a chamada terminar, contendo todos os detalhes da chamada numa única nota. Se um agente editar posteriormente as etiquetas ou anotações da chamada em **CloudTalk > Histórico de chamadas > Detalhes de chamada** enquanto o ticket do Zendesk ainda estiver aberto, a CloudTalk adiciona automaticamente uma nova nota interna com as informações atualizadas.
Esta definição dá-lhe flexibilidade: por exemplo, se a sua equipa quiser ver os tickets aparecerem no Zendesk imediatamente ou acionar workflows do Zendesk assim que uma chamada começa, utilize a opção **Respondido**.
Propriedades do ticket (aplicadas ao criar um novo ticket)
Estas definições aplicam-se apenas quando é criado um novo ticket.
* **com tipo**: Selecione o tipo de ticket do Zendesk (por exemplo, Problem, Incident, Task).
* **com o estado**: Selecione o estado do ticket do Zendesk (por exemplo, New, Open, Pending, Solved).
* **Com prioridade**: Selecione a prioridade do ticket do Zendesk (Low, Normal, High, Urgent).
Regras de atribuição
Utilize a definição **Atribuir a** para controlar como os tickets criados para este tipo de chamada são atribuídos no Zendesk.
Pode escolher entre as seguintes opções:
* **Atribuição automática**
O ticket é atribuído ao utilizador do Zendesk cujo endereço de email corresponde ao do agente da CloudTalk que tratou a chamada.
O grupo do Zendesk é atribuído automaticamente com base no grupo a que o agente pertence no momento da exportação da chamada.
* **Atribuir a utilizador**
Todos os tickets criados para este tipo de chamada são atribuídos a um utilizador específico do Zendesk que selecionar.
* **Atribuir a grupo**
Todos os tickets criados para este tipo de chamada são atribuídos a um grupo específico do Zendesk que selecionar.
* **Não atribuir**\
Os tickets criados para este tipo de chamada ficam completamente sem atribuição no Zendesk, sem responsável e sem grupo definido. Ao contrário da Atribuição automática, que associa o ticket a um utilizador do Zendesk através do email, esta opção garante que o ticket permanece sem atribuição. Isto é útil se os seus próprios triggers ou regras de encaminhamento do Zendesk tratarem da atribuição.
Connected Numbers (para chamadas)
Utilize esta definição para controlar quais os números da CloudTalk que exportam chamadas para o Zendesk.
Quando seleciona um ou mais números no campo **Connected Numbers (para chamadas)**:
* Apenas as chamadas efetuadas ou recebidas através dos números selecionados serão exportadas para o Zendesk.
* As chamadas de outros números da CloudTalk não serão registadas.
Se não forem selecionados números, as chamadas de todos os números da CloudTalk serão exportadas de acordo com as regras de tipo de chamada configuradas.
Substituições de números (para chamadas)
Utilize as Substituições de números para aplicar regras de exportação de chamadas diferentes a números específicos da CloudTalk.
Cada número pode ter a sua própria configuração de tipo de chamada. Quando existe uma substituição para um número, esta tem prioridade sobre as definições globais de tipo de chamada. A integração verifica primeiro se existe uma regra para o número e o tipo de chamada específicos. Se não estiver configurada nenhuma substituição, é aplicada a regra global de tipo de chamada.
Definições do fluxo de trabalho para SMS
Utilize esta secção para controlar como as mensagens SMS são registadas no Zendesk.
* **Exportar SMS para o Zendesk** ativa ou desativa a sincronização de SMS.
* **Registar SMS recebida** cria um ticket do Zendesk para mensagens recebidas, utilizando o estado e o tipo de ticket selecionados.
* **Registar SMS enviada** cria ou atualiza um ticket do Zendesk para mensagens enviadas, utilizando o estado e o tipo de ticket selecionados.
Mapeamento de campos personalizados
Os administradores podem mapear os dados de chamadas da CloudTalk para campos personalizados de tickets do Zendesk. Isto permite que os detalhes das chamadas sejam automaticamente armazenados em campos estruturados, disponibilizando-os para relatórios no Zendesk Explore. Este mapeamento é acionado quando uma chamada termina.
Para saber como configurar o mapeamento de campos personalizados, consulte [Configurar o Mapeamento de Campos Personalizados para o Zendesk.](/pt/articles/14300299-configure-custom-field-mapping-for-zendesk)
Quando terminar as alterações, clique em **Guardar definições** para iniciar a sincronização e não se esqueça de ativar o botão **Ativo**. Pode atualizar as definições da integração a qualquer momento a partir da página de definições da integração no seu dashboard da CloudTalk.
Instalar o CTI da CloudTalk
**O nosso CTI para Zendesk suporta casos de utilização** de chamadas de entrada e de saída. O envio de mensagens SMS também está disponível através da secção **Mensagens** do CTI.
Passos a partir do Zendesk
1. Aceda ao [Zendesk marketplace](http://Zendesk.com/marketplace) e pesquise por CloudTalk.
2. Selecione a [aplicação CloudTalk for Support](https://www.zendesk.com/apps/support/cloudtalk/). Instale.
3. Selecione a conta do Zendesk na qual pretende instalar a aplicação e selecione **Install**. (Se aplicável, certifique-se de que se trata da mesma conta para a qual configurou a integração de dados.)
4. **Opcional:** Escolha se pretende aplicar restrições de segurança à sua integração atribuindo grupos ou funções de utilizador que possam aceder a esta instância de integração. Selecione **Update** para finalizar.
1. *Pode atualizar estas definições a qualquer momento a partir do portal de administração do Zendesk*: `{yourZendeskDomainName}.zendesk.com/admin/apps-integrations/apps/support-apps`
5. Depois de a aplicação CloudTalk for Support estar instalada, verá o logótipo da CloudTalk na barra de ferramentas. Selecione este logótipo para iniciar sessão no seu CloudTalk Phone, caso seja a primeira utilização ou se tiver iniciado sessão anteriormente noutro local.
1. Poderá ser necessário permitir o acesso ao microfone no seu navegador.
2. Durante a configuração inicial, pode selecionar as opções relativas ao comportamento do seu CloudTalk Phone dentro do Zendesk.
6. Depois de iniciar sessão, o seu CloudTalk Phone está pronto a ser utilizado no Zendesk.
**Já utiliza apenas a sincronização de dados?**
Se anteriormente ativou apenas a integração de dados e agora pretende adicionar o CTI, **não** precisa de reinstalar a integração do Zendesk.
A integração de dados e o CTI são independentes. Basta seguir os passos na secção [Instalar o CTI da CloudTalk](#:~:text=your%20CloudTalk%20dashboard.-,Install%20CloudTalk%20CTI,-Our%20Zendesk%20CTI) acima para ativar o CTI.
Desligar ou remover a integração
Se já não pretende que a CloudTalk sincronize dados com o Zendesk, pode desativar ou remover permanentemente a integração.
Para **desativar a integração**, vá a **Conta > Integrações**, localize a integração **Zendesk** e altere o estado de **Ativo** para **Inativo**.
Para **eliminar a integração permanentemente**, abra as definições da integração do Zendesk, percorra a página para baixo, clique em **Eliminar integração** e escreva **DELETE** para confirmar.
***
*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 ajudar.
## Related topics
- [Configurar o Zendesk Sell](/pt/articles/3722182-configure-zendesk-sell.md)
- [Utilizar a CloudTalk com o Zendesk Sell](/pt/articles/5372885-using-cloudtalk-with-zendesk-sell.md)
- [Utilizar a CloudTalk com o Zendesk](/pt/articles/5370637-using-cloudtalk-with-zendesk.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.
3. Introduza o seu **domínio do Zendesk**.
4. Será redirecionado para uma página de início de sessão do Zendesk para aceder à sua conta. Selecione **Authorize** e siga o processo de autorização.
* **Título**
Personalize o nome desta instância de integração
* **Etiqueta do contacto**
Defina uma etiqueta que será adicionada automaticamente aos contactos sincronizados a partir do Zendesk
* **Sincronizar tickets do Zendesk**
Ative esta opção para ativar a sincronização de tickets entre o Zendesk e a CloudTalk.
Na secção **Definições de exportação de chamadas**, pode configurar a forma como as chamadas são registadas, atribuídas e enriquecidas no Zendesk.
1. **Escolha quando as chamadas devem ser registadas com base na sua política de Horário de funcionamento.**\
Pode selecionar como a CloudTalk deve tratar as chamadas em relação ao horário de funcionamento configurado. Por exemplo, se escolher **Registar todas as chamadas**, todas as chamadas serão exportadas independentemente da hora.
2. **Criar novos contactos no Zendesk para números de chamada não associados.**\
Quando ativada, a CloudTalk cria automaticamente um novo contacto no Zendesk se for feita ou recebida uma chamada de um número que não existe no Zendesk.
3. **Importar o agente atribuído ao último ticket ativo como agente preferido do contacto.**\
Quando ativada, a CloudTalk atribui o agente do Zendesk do ticket ativo mais recente como agente preferido desse contacto na CloudTalk.
4. **Escolha como os dados das chamadas são exportados como notas internas.**
Pode ativar uma ou mais das seguintes opções:
1. **Exportar toda a chamada como notas internas**\
Quando ativada, todos os detalhes da chamada (notas, metadados, links e gravações) são adicionados como comentários internos no Zendesk.
2. **Exportar apenas a gravação e os links do cliente como notas**\
Quando ativada, apenas a gravação da chamada e o link do contacto na CloudTalk são exportados como notas internas.
3. **Exportar apenas as anotações da chamada como notas internas**\
Quando ativada, apenas as anotações da chamada do agente são exportadas como comentários internos.
As notas internas não são visíveis para os clientes.
5. **Ativar o registo de chamadas do VoiceAgent.**\
Quando ativada, as chamadas do VoiceAgent são exportadas para o Zendesk e etiquetadas em conformidade. Também pode escolher como os tickets do VoiceAgent são atribuídos através do menu pendente **Atribuir chamadas do VoiceAgent a**.
6. **Adicionar a gravação da chamada e a transcrição ao tíquete.**\
Quando ativada, a CloudTalk carrega a gravação da chamada e a transcrição para o ticket do Zendesk como um comentário de voz.
**Importante:** Se uma gravação ou transcrição é exportada depende das suas [Definições do fluxo de trabalho](/pt/articles/5450779-configuring-workflow-automations) de Exportação de Chamadas.\
Se um tipo de chamada estiver configurado para não ser registado (por exemplo, chamadas de saída não atendidas), a respetiva gravação e transcrição **não** serão exportadas.
Utilize esta definição para controlar quais os números da CloudTalk que exportam chamadas para o Zendesk.
Quando seleciona um ou mais números no campo **Connected Numbers (para chamadas)**:
* Apenas as chamadas efetuadas ou recebidas através dos números selecionados serão exportadas para o Zendesk.
* As chamadas de outros números da CloudTalk não serão registadas.
Se não forem selecionados números, as chamadas de todos os números da CloudTalk serão exportadas de acordo com as regras de tipo de chamada configuradas.
Cada número pode ter a sua própria configuração de tipo de chamada. Quando existe uma substituição para um número, esta tem prioridade sobre as definições globais de tipo de chamada. A integração verifica primeiro se existe uma regra para o número e o tipo de chamada específicos. Se não estiver configurada nenhuma substituição, é aplicada a regra global de tipo de chamada.
Utilize esta secção para controlar como as mensagens SMS são registadas no Zendesk.
* **Exportar SMS para o Zendesk** ativa ou desativa a sincronização de SMS.
* **Registar SMS recebida** cria um ticket do Zendesk para mensagens recebidas, utilizando o estado e o tipo de ticket selecionados.
* **Registar SMS enviada** cria ou atualiza um ticket do Zendesk para mensagens enviadas, utilizando o estado e o tipo de ticket selecionados.
2. Selecione a [aplicação CloudTalk for Support](https://www.zendesk.com/apps/support/cloudtalk/). Instale.
3. Selecione a conta do Zendesk na qual pretende instalar a aplicação e selecione **Install**. (Se aplicável, certifique-se de que se trata da mesma conta para a qual configurou a integração de dados.)
4. **Opcional:** Escolha se pretende aplicar restrições de segurança à sua integração atribuindo grupos ou funções de utilizador que possam aceder a esta instância de integração. Selecione **Update** para finalizar.
1. *Pode atualizar estas definições a qualquer momento a partir do portal de administração do Zendesk*: `{yourZendeskDomainName}.zendesk.com/admin/apps-integrations/apps/support-apps`
5. Depois de a aplicação CloudTalk for Support estar instalada, verá o logótipo da CloudTalk na barra de ferramentas. Selecione este logótipo para iniciar sessão no seu CloudTalk Phone, caso seja a primeira utilização ou se tiver iniciado sessão anteriormente noutro local.
1. Poderá ser necessário permitir o acesso ao microfone no seu navegador.
2. Durante a configuração inicial, pode selecionar as opções relativas ao comportamento do seu CloudTalk Phone dentro do Zendesk.
6. Depois de iniciar sessão, o seu CloudTalk Phone está pronto a ser utilizado no Zendesk.
Para **eliminar a integração permanentemente**, abra as definições da integração do Zendesk, percorra a página para baixo, clique em **Eliminar integração** e escreva **DELETE** para confirmar.
***
*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 ajudar.
## Related topics
- [Configurar o Zendesk Sell](/pt/articles/3722182-configure-zendesk-sell.md)
- [Utilizar a CloudTalk com o Zendesk Sell](/pt/articles/5372885-using-cloudtalk-with-zendesk-sell.md)
- [Utilizar a CloudTalk com o Zendesk](/pt/articles/5370637-using-cloudtalk-with-zendesk.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.