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
- No Agendor, entre com o usuário administrador e abra Menu → Integrações → Token da API.
- Copie o token.
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Agendor e clique em Conectar.
- Cole o token em Token de API.
- 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.