Como gerar tokens de API?
Os tokens de API são a chave de cada integração na Amplifique.me. Aprenda a criar, nomear e configurar um token vinculado a uma pesquisa e canal específicos para uso em webhooks e integrações externas.
Visão geral
Os tokens de API são gerados dentro da Amplifique.me e usados para autenticar as requisições de envio de pesquisas disparadas por sistemas externos. Cada token é vinculado a uma pesquisa e canal específicos — você pode criar quantos tokens precisar, um por integração.
Apenas usuários com perfil de Proprietário ou Administrador podem criar e gerenciar tokens de API.
Como criar um token de API
Acesse Integrações → API
No menu lateral, clique nos três pontos (⋯) → Integrações → API.
Clique em Criar token
Um formulário de criação será exibido.
Nomeie o token
Use um nome que identifique claramente o propósito da integração. Recomendamos o padrão:
[Sistema] - [Gatilho] - [Pesquisa]
Exemplos:
-
ActiveCampaign - Novo Lead - Pesquisa CSAT -
Zendesk - Fechamento de Ticket - NPS Suporte -
Tiny ERP - Pedido Faturado - CSAT Pós-Compra
Selecione a pesquisa e o canal
Escolha a pesquisa que será disparada e o canal de envio: E-mail, SMS ou WhatsApp.
Configure atraso ou agendamento (opcional)
Se quiser que o envio aconteça com um intervalo após o gatilho, configure:
-
Atraso em minutos/horas — útil para enviar a pesquisa horas após o atendimento, por exemplo
-
Horário específico — agenda o disparo para um período do dia
Um atraso de 2 a 24 horas é uma boa prática para pesquisas pós-atendimento — evita o envio imediato enquanto o cliente ainda está resolvendo o problema.
Salve e copie a URL gerada
Após salvar, a URL do webhook estará disponível no formato:
https://integration.services.amplifique.me/{sistema}/cf/webhook?access_token=Bearer+SEU_TOKEN
Essa URL é inserida no sistema parceiro para ativar o gatilho.
Trate o token como uma senha — ele dá acesso ao envio de pesquisas na sua conta. Não compartilhe publicamente.
Visualizando e auditando requisições
Para monitorar os envios realizados via token:
-
Acesse Integrações → API → Ver integrações → Ir ao painel
-
Cada token exibe o histórico de requisições recebidas
-
Clique no ícone de olho ao lado do token para ver erros de requisição
-
Clique no nome de um contato para ver os dados completos enviados na requisição
Perguntas frequentes
Para cada combinação de pesquisa + canal + sistema. Se você usa o mesmo sistema (ex: Zendesk) para disparar dois tipos de pesquisa (NPS e CSAT), crie um token separado para cada uma.
O webhook no sistema parceiro deixa de funcionar — novas requisições para aquela URL retornarão erro. Sempre desative o webhook no sistema parceiro antes de deletar o token na Amplifique.me.
Tecnicamente sim, mas não é recomendado. Tokens separados por sistema facilitam o monitoramento, a auditoria de erros e a revogação individual em caso de problemas.
Tutorial em Vídeo
Próximo passo
Como funcionam as integrações?
Veja a lista de integrações disponíveis e o funcionamento geral do disparo automático de pesquisas.
Last updated 5 days ago
Built with Documentation.AI