Skip to main content
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 o separador 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 navegação do lado esquerdo, vá a Conta > Definições.
  3. Selecione o separador Chaves da API no topo da página.
O URL direto é: dashboard.cloudtalk.io/menu/account/settings/API-keys

​
Como gerar uma nova Chave da API

  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.
⚠️ 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
  • 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

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