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

# Como aceder e gerar as suas chaves da API da CloudTalk

> Saiba onde encontrar as suas Chaves da API na CloudTalk e como gerar uma nova chave e segredo para utilizar com integrações e com a API da CloudTalk.

<Note>
  Neste artigo, vai aprender onde encontrar as suas Chaves da API no CloudTalk Dashboard e como gerar uma nova chave e segredo. As Chaves da API são necessárias para ligar a CloudTalk a ferramentas de terceiros, como o Zapier, o Make e integrações personalizadas.
</Note>

**Nível de utilizador**: Admin

***

<h2 id="h_what_are_api_keys">
  O que são as Chaves da API?
</h2>

As Chaves da API da CloudTalk são um par de credenciais, um **Access Key ID** e um **Access Key Secret**, utilizadas para autenticar pedidos à API da CloudTalk. São necessárias sempre que liga a CloudTalk a uma plataforma externa ou a uma ferramenta de automação.

<Warning>
  ⚠️ O acesso à API está disponível no **plano Essential e superiores**. Se não vir o separador Chaves da API, confirme que a sua conta foi atualizada para o plano correto.
</Warning>

<h2 id="h_where_to_find">
  Onde encontrar as suas Chaves da API
</h2>

As Chaves da API encontram-se na secção **Definições** do seu CloudTalk Dashboard.

1. Inicie sessão no seu [CloudTalk Dashboard](https://dashboard.cloudtalk.io).

2. Na navegação do lado esquerdo, vá a **Conta > Definições**.

3. Selecione o separador **Chaves da API** no topo da página.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15272380/e8b3fc636231-screenshot-2026-05-27-at-10-45-36.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=8b045da3518f840b75b2dab0c23de2b5" alt="" width="2630" height="950" data-path="images/help-center/articles/15272380/e8b3fc636231-screenshot-2026-05-27-at-10-45-36.png" />
</Frame>

<Warning>
  O URL direto é: [dashboard.cloudtalk.io/menu/account/settings/API-keys](https://dashboard.cloudtalk.io/menu/account/settings/API-keys)
</Warning>

<h2 id="h_generate_new_key">
  Como gerar uma nova Chave da API
</h2>

1. Navegue até **Conta > Definições > Chaves da API**, conforme descrito acima.

2. Clique no botão **`+ Adicionar chave de API`**.

3. São gerados um novo **Access Key ID** e um novo **Access Key Secret**.

4. Copie e guarde ambos os valores em segurança. Pode consultar o seu segredo a qualquer momento clicando no botão **Mostrar** junto à chave, na página Chaves da API.

<Warning>
  ⚠️ Trate o segredo da sua Chave da API como uma palavra-passe. Não o partilhe nem o guarde num local inseguro.
</Warning>

<h2 id="h_common_uses">
  Utilizações comuns das Chaves da API
</h2>

Depois de ter o seu ID e Segredo da Chave da API, pode utilizá-los para se autenticar com:

* **Zapier**: ao ligar uma nova conta CloudTalk no editor de Zaps para acionar ou executar ações sobre chamadas, SMS e contactos

* **HubSpot Workflows**: ao acionar chamadas de saída do VoiceAgent ou ao enviar SMS através da API da CloudTalk como ação de um fluxo de trabalho

* **Pipedrive Automations**: ao enviar pedidos de webhook para a CloudTalk, por exemplo para acionar SMS quando um negócio muda de fase

* **Automações de fluxo de trabalho da CloudTalk**: ao configurar ações de pedido à API no construtor de automações integrado no Dashboard

* **Chamadas diretas à API**: utilizando a Autenticação Básica com a API REST da CloudTalk para integrações personalizadas ou testes de programação (por exemplo, no Postman). Consulte a [Referência da API da CloudTalk](/developers) para conhecer todos os endpoints disponíveis.

<h2 id="h_troubleshooting">
  Resolução de problemas
</h2>

* **Separador Chaves da API não visível**: Confirme que a sua conta tem o plano Essential ou superior e que iniciou sessão com uma função de Admin. Se o separador continuar a não aparecer depois de verificar o plano, contacte o Suporte da CloudTalk.

* **Erros de autenticação**: Certifique-se de que não ficam espaços a mais ao colar o ID da Chave ou o Segredo. Gere um novo par de chaves se o problema persistir.

* **Erros 404 ou «Not a valid request»**: Certifique-se de que está a utilizar o URL base correto da API: `https://api.cloudtalk.io`. O URL do dashboard (`my.cloudtalk.io`) não disponibiliza a API pública e devolve erros se for utilizado em pedidos à API. Todos os caminhos de endpoint têm também de terminar com `.json`.

<Tip>
  Para consultar a documentação completa da API, visite [developers.cloudtalk.io](/developers).
</Tip>

***

*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

- [Integrar um CRM personalizado ou interno com a CloudTalk](/pt/articles/16012908-integrating-a-custom-or-in-house-crm-with-cloudtalk.md)
- [Acionar uma chamada do VoiceAgent a partir do Zoho Desk](/pt/articles/15442851-triggering-a-voiceagent-call-from-zoho-desk.md)
- [Acionar uma chamada do VoiceAgent a partir do Freshworks CRM](/pt/articles/15477534-triggering-a-voiceagent-call-from-freshworks-crm.md)


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