Como conectar o Feegow 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 Feegow, como um arquivo de texto em Arquivos, na ficha do paciente daquela conversa.

• O paciente é encontrado pelo número do WhatsApp. O ZipTalk procura o número com e sem o código do país e, nos celulares do Brasil, com e sem o nono dígito. Ele só usa um paciente quando um dos telefones da ficha é mesmo esse número.
• Se o paciente ainda não existir no Feegow, o ZipTalk cadastra, sem CPF, com o nome do perfil do WhatsApp e o celular. Emojis e símbolos ficam fora do nome. Quando não sobra nome, o paciente fica com o número no lugar.
• Nada entra em anamneses nem em evoluções. O prontuário clínico continua com o profissional.
• O texto sai no idioma do número, o mesmo da transcrição que o time recebe no WhatsApp.
• Vão para o Feegow 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.

Na página da integração, o ZipTalk chama cada envio de "nota", como faz com os outros CRMs. No Feegow, cada nota vira um arquivo na ficha do paciente.

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 administrador da licença no Feegow, para gerar o token da API Pública.

1. Abra a integração no ZipTalk

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

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

2. Gere o token no Feegow

No Feegow, um administrador gera o token em Configurações > Outras Configurações > API Pública. Na janela do ZipTalk, o link Abrir no Feegow abre essa página numa aba nova.

No cadeado do token, marque:

• Listar pacientes
• Informações
• Criar paciente
• Upload de arquivo
• Listar unidades

Ao conectar, o ZipTalk confere só Listar pacientes. Se faltar outra, a conexão é aceita e o problema só aparece quando as notas começam a sair. Sem Listar unidades, as notas saem normalmente, mas a página não mostra o nome da clínica.

Copie o token.

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

• Se o Feegow aceitar, aparece o aviso "Feegow conectado." e a janela fecha.
• Se recusar, a janela avisa que o Feegow não aceitou. Confira se copiou o token inteiro, se ele está ativo e se Listar pacientes está marcado no cadeado.

4. Confira a conexão

A página do Feegow no ZipTalk mostra Conectado, em Conta o nome da clínica no Feegow, 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. As notas entregues não trazem link para abrir a ficha no Feegow.

Escolha o que vira nota

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

Cada transcrição entra como um arquivo de texto em Arquivos, na ficha do paciente, logo depois de o áudio ou a ligação ser transcrito.

• A descrição do arquivo, que é como o Feegow lista os arquivos, diz o que foi, com a duração, e a data e a hora da conversa no horário de Brasília. Por exemplo: "Áudio recebido no WhatsApp (1:05) · 29/10/2026 14:30".
• O que foi aparece como "Áudio recebido no WhatsApp", "Áudio enviado no WhatsApp" ou "Ligação no WhatsApp".
• Dentro do arquivo vêm a mesma linha, o número do time em que a conversa aconteceu, o resumo (quando houver) e a transcrição.
• O texto termina com "Registrado pelo ZipTalk".

No Feegow, Arquivos tem uma permissão própria, separada da de anamneses e evoluções.

Se o Feegow estiver fora do ar ou recusar um arquivo, 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 Feegow no ZipTalk, com a mensagem que o Feegow devolveu.

Desconectar no ZipTalk

Na página do Feegow 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.
• Os pacientes e os arquivos que já estão no Feegow continuam lá. O ZipTalk não apaga nada no Feegow.
• O ZipTalk não desativa o token no Feegow. Isso fica com você, no próprio Feegow.

Seus dados

• O token fica guardado criptografado no ZipTalk e só serve para mandar as transcrições ao Feegow. Depois de colado, ele não volta para o navegador.
• O arquivo vai dentro do próprio envio ao Feegow, sem link para baixar.
• A transcrição fica na fila do ZipTalk só até o arquivo chegar ao Feegow, e é apagada em no máximo 14 dias.
• O ZipTalk guarda qual paciente do Feegow corresponde a cada número, para não cadastrar o mesmo paciente duas vezes. Isso é apagado quando você desconecta.
• A transcrição pode ter dados de saúde do paciente. Nesse caso, a clínica é a controladora desses dados, e o ZipTalk só leva a transcrição ao Feegow, por instrução da clínica.

Mais detalhes na Política de Privacidade.

Se algo não funcionar

• O Feegow não aceitou o token ao conectar: confira se copiou o token inteiro, se ele está ativo e se Listar pacientes está marcado no cadeado.
• Precisa reconectar: o Feegow passou a recusar o token. Pode ser um token desativado ou uma permissão desmarcada no cadeado. Os donos e admins do time recebem um aviso por notificação e e-mail. Corrija no Feegow, clique em Atualizar token na página do Feegow no ZipTalk e cole o token, mesmo que seja o mesmo de antes. 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 Feegow: a página mostra o último erro que o Feegow 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, mas o prazo de 14 dias continua contando de quando ela entrou na fila. 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.
• Uma conversa nunca vira nota: o ZipTalk precisa do número do contato para achar o paciente. 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 Feegow.