Integração

Para quem conecta o RecommenderPro ao sistema de gestão ou ao e-commerce: o formato do arquivo, as requisições, a resposta e as regras a respeitar. Se preferir, nós acompanhamos a conexão.

Três passos, com exemplos

1
Você exporta o histórico
Um arquivo de texto, sem cabeçalho. Cada linha é uma compra: o cliente, um ponto e vírgula, o produto.
```
C0042;cafe-em-graos-1kg
C0042;descalcificante
C0117;cafe-em-graos-1kg
C0117;jogo-xicaras-6
```
Você carrega o arquivo
Pelo “Facts Archive” (o arquivo de fatos) do web app ou pela API. A importação acontece em segundo plano, em blocos de 5.000 linhas, e você acompanha em “Recent imports” (importações recentes). Recarregar um arquivo de fatos com o mesmo nome o substitui.
3
Seu sistema pede as sugestões
Para um cliente, faz uma requisição GET com o código dele. Para um carrinho, faz uma requisição POST com a lista de produtos, como no exemplo mais abaixo. A resposta tem sempre esta forma.
```
GET /api/suggestions/noratings/users/C0042/vendas?minscore=60&max=5

{
  "_count": 1,
  "items": [
    { "prod": "jogo-xicaras-6", "score": 72.5 }
  ]
}
```

Para um carrinho

O seu sistema envia os produtos que o carrinho contém. A resposta tem a mesma forma da resposta para um cliente.

POST /api/suggestions/noratings/products/vendas?minscore=60&max=5

{ "products": ["cafe-em-graos-1kg", "descalcificante"] }

Parâmetros

Parâmetro	Significado	Valor padrão
`minscore`	Pontuação mínima, de 0 a 100	60
`max`	Número máximo de produtos devolvidos, até 100	10

Como a pontuação é calculada está em Como funciona.

O que é preciso

Um arquivo com duas colunas separadas por ponto e vírgula. As linhas vazias e as que começam com # são ignoradas. Um campo vazio faz o arquivo ser rejeitado, e ele é verificado antes do carregamento.
O nome do arquivo de fatos usa letras, dígitos e sublinhado (_), começa com uma letra e tem até 30 caracteres.
Os identificadores usados nas requisições da API contêm letras, dígitos, hífen e sublinhado, até 100 caracteres. Espaços não são permitidos.
As requisições de sugestões precisam de um token de acesso.

Precisa de ajuda?

Nós, da bit Time Professionals, acompanhamos a conexão: treinamento sobre a integração com o software que você já usa e suporte. Conversamos sobre isso depois da demonstração.

Quer ver o que o RecommenderPro sugeriria aos seus clientes?

Mostramos o web app e como ele se conecta ao seu e-commerce ou ao seu sistema de gestão. Se você decidir começar, acompanhamos você na integração.

Pedir uma demo