Guias
Como conectar o Kommo ao ZipTalk
Cada áudio e ligação que o ZipTalk transcreve vira uma nota no contato certo do Kommo. 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 Kommo, como uma nota no contato daquela conversa.
- O contato é encontrado pelo número do WhatsApp. O ZipTalk acha o número escrito com ou sem o código do país e, nos celulares do Brasil, com ou sem o nono dígito.
- Se o contato ainda não existir no Kommo, o ZipTalk cria, com o nome do perfil do WhatsApp e o telefone. Quando o WhatsApp não traz nome, o contato fica com o número no lugar do nome.
- A nota fica no contato. O ZipTalk não cria leads nem mexe nos que já existem.
- A nota sai no idioma do número, o mesmo da transcrição que o time recebe no WhatsApp.
- Vão para o Kommo os áudios e as ligações transcritos depois que você conecta. As conversas antigas ficam de fora.
- 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 Kommo com acesso à conta que vai receber as notas.
Enquanto o Kommo não aprova o app do ZipTalk, a integração pode aparecer como Em breve, sem o botão Conectar. Nesse caso, ela ainda não está liberada para o seu time.
1. Abra a integração no ZipTalk
Entre no ZipTalk e clique em Integrações no menu lateral. Na linha do Kommo, clique em Conectar.

O mesmo botão aparece na página do Kommo no ZipTalk, que abre pelo ícone de configurações no fim da linha.

2. Autorize no Kommo
A tela de autorização do Kommo abre numa janela nova. Confira o pedido e autorize o ZipTalk.
O ZipTalk usa esse acesso só para o que a integração faz:
- Procurar o contato pelo número de telefone.
- Criar o contato que ainda não existe.
- Registrar a nota no contato.
- Ler o nome da conta do Kommo, para mostrar qual foi conectada.
Se o navegador bloquear a janela nova, a autorização abre na mesma aba e, no fim, volta para a página do Kommo no ZipTalk.
3. Confira a conexão
Depois de autorizar, a janela do Kommo fecha sozinha, o ZipTalk avisa que o Kommo foi conectado e a linha dele passa a mostrar Conectado.
Na página do Kommo no ZipTalk aparecem Conectado, o nome da conta do Kommo e quando saiu a última nota.

Escolha o que vira nota
Em O que vira nota, escolha se o Kommo 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. Uma nota que ainda estava na fila quando você desligou o tipo dela não sai e aparece como Não enviada.
Como a nota aparece no Kommo
Cada transcrição entra como uma nota de texto no contato, em geral menos de um minuto depois de o áudio ou a ligação ser transcrito. A nota traz:
- O que foi, com a duração: "Áudio recebido no WhatsApp", "Áudio enviado no WhatsApp" ou "Ligação no WhatsApp".
- Em qual número do time a conversa aconteceu.
- O resumo, quando houver, e a transcrição.
- No fim, "Registrado pelo ZipTalk".
Se o Kommo estiver fora do ar ou recusar a nota, o ZipTalk tenta de novo sozinho ao longo de algumas horas.
Em Últimas notas, na página do Kommo no ZipTalk, você vê as notas dos últimos 14 dias e como cada uma ficou: Entregue, Aguardando, Com erro ou Não enviada. Nas entregues, um ícone ao lado abre o contato direto no Kommo.

Desconectar no ZipTalk
Na página do Kommo 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 Kommo.
- Notas que ainda estavam na fila para sair são descartadas.
- Os contatos e as notas que já estão no Kommo continuam lá. O ZipTalk não apaga nada no Kommo.
- O ZipTalk não desfaz a autorização do lado do Kommo. Isso fica com você, no próprio Kommo.
Se o acesso for removido no Kommo
Se o Kommo deixar de aceitar o acesso do ZipTalk, por exemplo porque a autorização foi removida por lá:
- Na próxima vez que o ZipTalk tentar usar o acesso, a integração 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 Kommo continuam lá.
- Para parar de vez, desconecte também no ZipTalk.
Seus dados
- O acesso ao Kommo fica guardado criptografado no ZipTalk e nunca chega ao navegador.
- A transcrição fica na fila do ZipTalk só até a nota chegar ao Kommo. Os registros da fila são apagados depois de 14 dias, com a nota entregue ou não.
- O ZipTalk guarda qual contato do Kommo 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 Kommo recusou o acesso. Clique em Reconectar na página do Kommo no ZipTalk. As notas que estavam esperando saem em alguns minutos.
- Algumas notas não chegaram ao Kommo: a página mostra o último erro que o Kommo devolveu. Em Últimas notas, filtre por Com erro e clique em Tentar de novo na nota. Ela volta para a fila e sai em alguns minutos. Se o erro 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.
- O tempo da conexão acabou: a tela de autorização ficou aberta mais de 10 minutos. Clique em Conectar de novo.
- Esse link de conexão foi aberto por outra pessoa: a autorização voltou para o ZipTalk com outro usuário logado, ou quem começou deixou de ser dono ou admin do time. Comece de novo e vá até o fim com o mesmo usuário.