Guias
Como conectar o HubSpot ao ZipTalk
Cada áudio e ligação que o ZipTalk transcreve vira uma nota no contato certo do HubSpot. Veja como conectar, configurar e desconectar.
O que a integração faz
Quando o ZipTalk transcreve um áudio ou uma ligação de WhatsApp de um número do seu time, a transcrição também vai para o HubSpot, como uma nota no contato daquela conversa.
- O contato é encontrado pelo número do WhatsApp. Se ainda não existir no HubSpot, o ZipTalk cria o contato com o nome e o telefone da conversa.
- A nota diz se foi um áudio recebido, um áudio enviado ou uma ligação, em qual número do time aconteceu, e traz o resumo (quando houver) e a transcrição.
- A nota sai no idioma do número, o mesmo da transcrição que o time recebe no WhatsApp.
- Tudo acontece sozinho. Não tem nada para enviar à mão.
Antes de começar
- Uma conta no ZipTalk com pelo menos um número de WhatsApp conectado e transcrevendo.
- Ser dono ou admin do time no ZipTalk. Só eles veem Integrações no menu e podem conectar ou mudar a integração.
- Um usuário do HubSpot com permissão para instalar apps na conta.
1. Abra a integração no ZipTalk
Entre no ZipTalk e clique em Integrações no menu lateral. Na linha do HubSpot, clique em Conectar.

Se você veio pelo marketplace do HubSpot, o botão de instalar já abre a página do HubSpot no seu time (sem login no ZipTalk, ele pede para entrar antes). Nela, clique em Conectar.

2. Autorize no HubSpot
O HubSpot abre a tela de autorização. Se você tiver mais de uma conta, escolha a que vai receber as notas. Confira o que o ZipTalk pede e clique em Connect app.

O ZipTalk pede só o que usa:
- Ver contatos, para achar o contato pelo número de telefone.
- Criar e editar contatos, para criar o contato que ainda não existe e registrar a nota nele.
- Dados básicos da conta, que todo app do HubSpot recebe, para saber qual conta foi conectada.
Enquanto o app não passa pela revisão do marketplace, o HubSpot avisa que ele ainda não foi revisado e pede que você digite uma frase de confirmação para continuar.
3. Confira a conexão
Depois de autorizar, a janela do HubSpot fecha sozinha e o ZipTalk mostra Conectado, o ID da conta do HubSpot e quando saiu a última nota.

Escolha o que vira nota
Em O que vira nota, escolha se o HubSpot recebe os Áudios, as Ligações ou os dois. Os dois começam ligados, e a mudança vale para as próximas transcrições.
Como a nota aparece no HubSpot
Cada transcrição entra na linha do tempo do contato como uma nota criada pelo ZipTalk, em geral menos de um minuto depois de o áudio ou a ligação ser transcrito. Se o HubSpot estiver fora do ar, o ZipTalk tenta de novo mais tarde.

Desconectar no ZipTalk
Na página do HubSpot no ZipTalk, abra o menu ⋮ no canto de cima, clique em Desconectar e confirme.

O que acontece com os seus dados:
- O ZipTalk para de enviar notas na hora e apaga o acesso que tinha ao HubSpot.
- Notas que ainda estavam na fila para sair são descartadas.
- Os contatos e as notas que já estão no HubSpot continuam lá. O ZipTalk não apaga nada no HubSpot.
- O app continua instalado no HubSpot até você desinstalar por lá.
Desinstalar o app no HubSpot
- No HubSpot, clique no ícone de configurações na barra de cima.
- No menu da esquerda, vá em Integrações > Apps conectados.
- Na linha do ZipTalk, abra Ações e clique em Desinstalar. Digite "desinstalar" para confirmar.
O que acontece com os seus dados:
- O HubSpot corta o acesso do ZipTalk. Na próxima nota que tentar enviar, o ZipTalk passa a mostrar Precisa reconectar, e os donos e admins do time recebem um aviso por notificação e e-mail.
- As notas novas ficam esperando por até 14 dias. Se você reconectar nesse prazo, elas saem. Depois disso, são descartadas.
- Os contatos e as notas que já estão no HubSpot continuam lá.
- Para parar de vez, desconecte também no ZipTalk.
Seus dados
- O acesso ao HubSpot fica guardado criptografado no ZipTalk e nunca chega ao navegador.
- A transcrição fica na fila do ZipTalk só até a nota chegar ao HubSpot. Os registros da fila são apagados depois de 14 dias, com a nota entregue ou não.
- O ZipTalk guarda qual contato do HubSpot corresponde a cada número, para não criar o mesmo contato duas vezes. Isso é apagado quando você desconecta.
Mais detalhes na Política de Privacidade.
Se algo não funcionar
- Precisa reconectar: o HubSpot recusou o acesso, por exemplo porque o app foi desinstalado. Clique em Reconectar na página do HubSpot no ZipTalk.
- Algumas notas não chegaram ao HubSpot: a página mostra o último erro que o HubSpot devolveu. O ZipTalk tenta de novo sozinho. Se o aviso continuar, fale com a gente.
- Nenhuma nota aparece: confira se Áudios e Ligações estão ligados e se o número está transcrevendo no WhatsApp.