Pular para o conteúdo

Conectando o Agendor

CRMConexão: credenciaisAtualizado em

Ver o que a Toca faz com o Agendor →

Em homologação

Abrir integrações no app

A conexão com o Agendor usa o token de API de um usuário da sua conta, que fica no próprio Agendor. Não há login nem senha a digitar: com o token, a Toca entra na API do Agendor a cada consulta, com as permissões desse usuário.

Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.

Antes de começar

  • Use o token de um usuário administrador. A API do Agendor obedece à privacidade da conta: com a privacidade fechada, o token de um colaborador mostra só os negócios, empresas, pessoas e tarefas de que ele é responsável, e os relatórios da equipe (como ganhos por vendedor) saem incompletos, sem aviso.
  • Cada usuário tem o seu token. Ele fica em Menu → Integrações → Token da API, entrando no Agendor com o usuário que você vai usar.
  • Trate o token como uma senha: ele dá acesso à conta pela API. Não mande por e-mail nem por chat.

Passo a passo

  1. No Agendor, entre com o usuário administrador e abra Menu → Integrações → Token da API.
  2. Copie o token.
  3. Acesse Configurações → Integrações na Toca.
  4. Localize o card Agendor e clique em Conectar.
  5. Cole o token em Token de API.
  6. Clique em Salvar. O card fica marcado como conectado.

O que a Toca acessa

Com a conexão ativa, a Toca lê os negócios, com valor, etapa, funil, status (em andamento, ganho ou perdido), motivo de perda, responsável, produtos e datas de início e conclusão; as movimentações dos negócios entre etapas; os funis e as etapas; as empresas e as pessoas, com contato, endereço, categoria, origem e setor; as tarefas e o histórico de atividades de cada cliente; os produtos; os usuários da conta; e os campos customizados.

A Toca também altera: cria negócios numa empresa ou pessoa, move negócios entre etapas e funis, marca ganho ou perdido (com o motivo) e reabre; altera valor, responsável e quem vê o negócio; agenda tarefas (ligação, reunião, visita, e-mail, proposta, WhatsApp), registra notas no histórico, conclui, reagenda e reabre tarefas; cadastra e altera empresas, pessoas e produtos; e ativa ou inativa usuários. Toda alteração só acontece mediante sua aprovação explícita, pedido a pedido, dentro do chat, e o pedido mostra a hora da tarefa no horário de Brasília.

Algumas alterações não se desfazem, e o pedido de aprovação diz isso: excluir negócio, empresa, pessoa, tarefa ou produto. Marcar um negócio como ganho ou perdido também pode avisar outros sistemas ligados ao seu Agendor (um ERP, por exemplo). A Toca não cria, não lê e não exclui webhooks do Agendor: eles mandam os dados do CRM para outros endereços e se configuram no próprio Agendor.

Manutenção da conexão

O token não vence. Ele deixa de valer quando alguém gera um token novo para o mesmo usuário em Menu → Integrações, ou quando o usuário é inativado. Nesse caso, copie o token novo, abra o card em Configurações → Integrações pelo botão Gerenciar, cole o token e clique em Atualizar. Por segurança, o token salvo aparece mascarado.

A API do Agendor aceita até 4 consultas por segundo. A Toca faz uma consulta por vez; em contas grandes, uma leitura longa pode levar alguns minutos.

Problemas comuns

  • O Agendor responde que o token não foi autenticado (401) — confira se o token foi colado inteiro, sem espaço sobrando, e se o usuário dono dele está ativo. Se alguém gerou um token novo, o antigo parou de valer: atualize no card.
  • Faltam negócios ou a contagem não bate com o painel — o token é de um colaborador e a privacidade da conta está fechada. Troque pelo token de um administrador.
  • O Agendor pede para esperar (429) — passou do limite de 4 consultas por segundo da API do Agendor. Espere alguns segundos e peça de novo.
  • A tarefa ficou no horário errado — a Toca manda a hora sempre com o fuso de Brasília e mostra a hora no pedido de aprovação. Confira a hora no pedido antes de aprovar.
  • Conectou a conta errada — use Excluir integração no menu ⋯ do card e conecte de novo, com o token da conta certa.

Outras integrações de crm

Abrir integrações no app