Saltar para o conteúdo principal
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.
Nível de utilizador: Admin

​
O que são as Chaves da API?

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.
⚠️ O acesso à API está disponível no plano Essential e superiores. Se não vir a página Chaves da API, confirme que a sua conta foi atualizada para o plano correto.

​
Onde encontrar as suas Chaves da API

As Chaves da API encontram-se na secção Definições do seu CloudTalk Dashboard.
  1. Inicie sessão no seu CloudTalk Dashboard.
  2. Na parte inferior do menu do lado esquerdo, clique em Definições.
  3. Selecione Chaves da API, a partir dos cartões na página inicial das Definições ou da lista em Definições na segunda coluna.
A página Chaves da API nas Definições, com o botão Adicionar Chave da API
O URL direto é: dashboard.cloudtalk.io/menu/account/settings/API-keys

​
Como gerar uma nova Chave da API

  1. Navegue até 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.
⚠️ Trate o segredo da sua Chave da API como uma palavra-passe. Não o partilhe nem o guarde num local inseguro.

​
Utilizações comuns das Chaves da API

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
  • Assistentes de IA (MCP): ao ligar o Claude, o Cursor ou outro assistente de IA à sua conta CloudTalk. Consulte Ligar assistentes de IA à CloudTalk (MCP).
  • 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 para conhecer todos os endpoints disponíveis.

​
Resolução de problemas

  • Página 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 a página 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 da API que está a chamar. Cada API tem o seu próprio URL base e formato de caminho. Consulte URLs base na referência da API.
Para consultar a documentação completa da API, visite developers.cloudtalk.io.
Precisa de ajuda ou tem alguma questão? Contacte-nos através do nosso Portal de Suporte - estamos aqui para si.