A CRM&Bônus é a plataforma de giftback e fidelidade da sua marca: o cliente ganha bônus na compra e usa o saldo na próxima. A conexão com a Toca usa as credenciais de API que o time de TI da CRM&Bônus entrega a cada marca. Não existe tela de autoatendimento para elas: quem fornece é o seu contato na CRM&Bônus.
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
- Peça ao seu contato de TI na CRM&Bônus as credenciais da API. A única obrigatória é o Authorization, que a CRM&Bônus entrega já codificado.
- Os demais campos dependem do que a sua marca usa: o Token de integração serve aos relatórios de bônus, extrato, vendas e NPS; o Código da empresa, ao e-commerce, ao PDV v1 e à geração de bônus em lote; usuário e senha do PDV v2, ao catálogo de produtos e ao cancelamento de venda; usuário e senha do Vale Bônus, um produto à parte, ao saldo, ao extrato e à recarga.
- Preencha só o que recebeu. Para os relatórios de bônus, o Authorization e o Token de integração bastam.
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card CRM Bonus e clique em Conectar.
- Preencha os campos com o que recebeu:
- Authorization — cole exatamente como recebeu, sem acrescentar nada e sem recodificar.
- Token de integração (opcional).
- Código da empresa (opcional).
- Usuário do PDV v2 e Senha do PDV v2 (opcionais).
- Usuário do Vale Bônus e Senha do Vale Bônus (opcionais).
- Clique em Salvar. O card fica marcado como conectado.
O que a Toca acessa
Com a conexão ativa, a Toca lê os bônus gerados, resgatados, a vencer, perdidos e cancelados, o saldo e o extrato de bônus de cada cliente, as campanhas disponíveis, as vendas totais e o NPS, os produtos do PDV e o saldo e o extrato de Vale Bônus.
A Toca também altera: gera, resgata e cancela bônus, registra e cancela vendas, envia ao cliente o SMS com o PIN, converte bônus em cupom, cadastra e altera produtos no catálogo e recarrega Vale Bônus. Toda alteração só acontece mediante sua aprovação explícita, pedido a pedido, dentro do chat, e o pedido de aprovação nomeia o pedido, o cliente e o valor.
Bônus e Vale Bônus são saldo do seu cliente: cancelar um bônus tira crédito de quem já foi avisado, e a CRM&Bônus não documenta como devolvê-lo. Alguns passos da venda no PDV v2 só funcionam pelo sistema do caixa e continuam lá.
Manutenção da conexão
A conexão vale enquanto as credenciais entregues pela CRM&Bônus valerem. Com o usuário e a senha do PDV v2 ou do Vale Bônus preenchidos, a Toca faz o login nesses serviços sozinha e renova a sessão automaticamente.
Se a CRM&Bônus trocar alguma credencial, abra o card em Configurações → Integrações pelo botão Gerenciar, substitua só o campo que mudou e clique em Atualizar. Por segurança, os valores salvos aparecem mascarados.
Problemas comuns
- A Toca avisa que falta um campo — cada parte da CRM&Bônus usa uma credencial: os relatórios pedem o Token de integração; o e-commerce, o PDV v1 e a geração em lote pedem o Código da empresa. Peça o campo que falta ao seu contato de TI e preencha pelo botão Gerenciar.
- Uma venda recente ainda não aparece nos relatórios — os relatórios da CRM&Bônus podem atrasar até 2 horas em relação à venda. A visão geral de bônus por cliente não tem esse atraso.
- Toda consulta falha logo depois de conectar — confira o Authorization: ele vai exatamente como a CRM&Bônus entregou, sem a palavra Bearer na frente e sem nova codificação. Na dúvida, peça o valor de novo ao seu contato.
- Consultas parecem lentas — a CRM&Bônus limita os relatórios a 10 requisições por segundo. Por isso a Toca faz no máximo duas consultas ao mesmo tempo.