Como conectar o Agendor ao ZipTalk

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 Agendor, como uma atividade na pessoa daquela conversa.

• A pessoa é encontrada pelo número do WhatsApp, em qualquer telefone cadastrado nela, com ou sem o código do país. Se ainda não existir no Agendor, o ZipTalk cria a pessoa com o nome do perfil do WhatsApp (ou com o número, quando não há nome) e guarda o número como o WhatsApp dela.
• A atividade entra já concluída, do tipo WhatsApp para áudio e Ligação para ligação. Fica no histórico da pessoa e não vira tarefa pendente de ninguém.
• Ela diz se foi um áudio recebido, um áudio enviado ou uma ligação, com a duração e o número do time em que aconteceu, e traz o resumo (quando houver) e a transcrição.
• O texto 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.

Na página da integração, o ZipTalk chama cada envio de "nota", como faz com os outros CRMs. No Agendor, cada nota vira uma atividade.

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 conectam e mudam a integração.
• Um usuário ativo no Agendor. A conexão usa o token de API desse usuário.

1. Abra a integração no ZipTalk

Entre no ZipTalk e clique em Integrações no menu lateral. Na linha do Agendor, clique em Conectar. Abre a janela Conectar o Agendor.

Se preferir, abra a página do Agendor pelo ícone de configurações no fim da linha e clique em Conectar lá. É a mesma janela.

2. Copie o token de API no Agendor

No Agendor, o token fica em Menu > Integrações. Na janela do ZipTalk, o link Abrir no Agendor abre essa página numa aba nova.

Copie o token de API do seu usuário.

3. Cole o token e conecte

Volte ao ZipTalk, cole o token no campo Token de API e clique em Conectar. Antes de salvar, o ZipTalk confere o token com o Agendor.

• Se o Agendor aceitar, aparece o aviso "Agendor conectado." e a janela fecha.
• Se recusar, a janela avisa que o Agendor não aceitou. Confira se copiou o token inteiro e se o seu usuário está ativo no Agendor.

4. Confira a conexão

A página do Agendor no ZipTalk mostra Conectado, em Conta o nome do usuário do Agendor dono do token, e quando saiu a última nota.

Em Últimas notas ficam as notas dos últimos 14 dias, cada uma com o status: Entregue, Aguardando, Com erro ou Não enviada. Uma nota entregue tem um link que abre a pessoa no Agendor.

Escolha o que vira nota

Em O que vira nota, escolha se o Agendor 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 atividade aparece no Agendor

Cada transcrição entra no histórico da pessoa como uma atividade concluída, logo depois de o áudio ou a ligação ser transcrito.

• O tipo é WhatsApp para áudio e Ligação para ligação.
• A data e a hora são as do áudio ou da ligação, no horário de Brasília.
• A atividade fica como concluída pelo usuário dono do token.
• O texto termina com "Registrado pelo ZipTalk".

Se o Agendor estiver fora do ar ou recusar uma atividade, o ZipTalk tenta de novo sozinho ao longo de algumas horas. Se ainda assim não der, a nota fica Com erro na página do Agendor no ZipTalk.

Desconectar no ZipTalk

Na página do Agendor 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 token que tinha guardado.
• Notas que ainda estavam na fila para sair são descartadas.
• As pessoas e as atividades que já estão no Agendor continuam lá. O ZipTalk não apaga nada no Agendor.

Seus dados

• O token fica guardado criptografado no ZipTalk e só serve para mandar as transcrições ao Agendor. Depois de colado, ele não volta para o navegador.
• A transcrição fica na fila do ZipTalk só até a atividade chegar ao Agendor, e é apagada em no máximo 14 dias.
• O ZipTalk guarda qual pessoa do Agendor corresponde a cada número, para não criar a mesma pessoa duas vezes. Isso é apagado quando você desconecta.

Mais detalhes na Política de Privacidade.

Se algo não funcionar

• O Agendor não aceitou o token ao conectar: confira se copiou o token inteiro e se o seu usuário está ativo no Agendor.
• Precisa reconectar: o Agendor passou a recusar o token. Os donos e admins do time recebem um aviso por notificação e e-mail. Na página do Agendor no ZipTalk, clique em Atualizar token e cole um token válido. As notas novas esperam por até 14 dias: se você atualizar nesse prazo, elas saem em alguns minutos. Depois disso, são descartadas.
• Algumas notas não chegaram ao Agendor: a página mostra o último erro que o Agendor devolveu. Em Últimas notas, filtre por Com erro e clique em Tentar de novo na nota. 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.
• Uma conversa nunca vira nota: o ZipTalk precisa do número do contato para achar a pessoa. Em algumas conversas o WhatsApp não informa o número, e os áudios e as ligações delas não vão para o Agendor.