Integração +fidelidade X TrustVox
Neste artigo vou mostrar como integrar com a TrustVox para dar pontos no programa de fidelidade.
Substitua o Store Id pelo número de store id informado pelo atendimento da Trust Vox
O endpoint abaixo deve receber uma requisição contendo os dados do pedido que deve ter sua opinião coletada.
Descritivo sobre os dados da requisição:
HTTP Method: POST
Content-Type: application/json
Accept: application/vnd.trustvox.com; version=1
Authorization: Bearer StoreToken (Alterar para o StoreToken fornecido por nossa equipe, este dado será diferente entre ambientes staging e produção.)
Request Body
order_id (number or string): identificador único do pedido (obrigatório)
delivery_date (string): data em que o pedido foi entregue (obrigatório)
client (object): dados sobre o consumidor (obrigatório)
e-mail (string): e-mail do consumidor (obrigatório)
first_name (string): primeiro nome do consumidor (obrigatório)
last_name (string): segundo nome do consumidor (obrigatório)
phone_number (string): telefone do consumidor (nos 5519900011111, +5519900011111, +55 (19) 900011111) (opcional)
tags (array of strings): trata-se de um array de strings sobre o cliente (Ex.: "Sexo/Masc", leia mais em article on structured tags) (opcional)
items (array of objects): dados sobre o produto ou serviço
id (string): Identificador do produto (deve ser o mesmo entregue no front-end) (obrigatório)
url (string): URL do produto (obrigatório)
name (string): nome do produto (obrigatório)
price (number): preço do produto (opcional)
photos_urls (array of strings): array de imagens do produto (opcional porém recomendado)
tags (array of strings): trata-se de um array de strings sobre o produto (Ex.: "Marca/Incrível", leia mais em article on structured tags) (opcional)
extra (object): campo utilizado para filtragens de produto onde não é permitida a coleta de opiniões (informar nossa equipe) (opcional)
seller (object): dados sobre o seller em caso de marketplace
id (string): identificador único do seller (obrigatório)
name (string): nome do seller (obrigatório)
logo (string): logotipo do seller (opcional)
tags (array of strings): trata-se de um array de strings sobre o pedido como um todo (Ex.: "Origem/LojaFisica", leia mais em article on structured tags) (opcional)
Segue um exemplo em cURL:
Esta requisição precisa ser feita para cada novo pedido finalizado/entregue pela empresa.
Com este a TrustVox receberá um(ou mais) pedidos na base deles e na sequência vão coletar opiniões via e-mail, com base nos dados informados no payload da requisição (pedido).
Sugerimos entrar em contato com a equipe da TrustVox para validarem se os pedidos encaminhados chegaram até a base deles.
No Link abaixo você fará a implementação das ferramentas visuais em seu Front-end de seu site.
Desça a barra de rolagem até TrustVox e clique no botão Configurar
Preencha o campo Informações com o StoreId e o StoreToken fornecidos pela TrustVox.
Passo 1 - Acessar a conta da TrustVox
Passo 2 - Entrar em contato com o atendimento da TrustVox, no símbolo de interrogação ❔ do seu painel e pedir o StoreId e o StoreToken
Passo 3 - Colar essa URL do Endpoint no seu navegador: https://trustvox.com.br/api/stores/store_id/orders
Substitua o Store Id pelo número de store id informado pelo atendimento da Trust Vox
O endpoint abaixo deve receber uma requisição contendo os dados do pedido que deve ter sua opinião coletada.
Descritivo sobre os dados da requisição:
HTTP Method: POST
Request Headers
Content-Type: application/json
Accept: application/vnd.trustvox.com; version=1
Authorization: Bearer StoreToken (Alterar para o StoreToken fornecido por nossa equipe, este dado será diferente entre ambientes staging e produção.)
Request Body
order_id (number or string): identificador único do pedido (obrigatório)
delivery_date (string): data em que o pedido foi entregue (obrigatório)
client (object): dados sobre o consumidor (obrigatório)
e-mail (string): e-mail do consumidor (obrigatório)
first_name (string): primeiro nome do consumidor (obrigatório)
last_name (string): segundo nome do consumidor (obrigatório)
phone_number (string): telefone do consumidor (nos 5519900011111, +5519900011111, +55 (19) 900011111) (opcional)
tags (array of strings): trata-se de um array de strings sobre o cliente (Ex.: "Sexo/Masc", leia mais em article on structured tags) (opcional)
items (array of objects): dados sobre o produto ou serviço
id (string): Identificador do produto (deve ser o mesmo entregue no front-end) (obrigatório)
url (string): URL do produto (obrigatório)
name (string): nome do produto (obrigatório)
price (number): preço do produto (opcional)
photos_urls (array of strings): array de imagens do produto (opcional porém recomendado)
tags (array of strings): trata-se de um array de strings sobre o produto (Ex.: "Marca/Incrível", leia mais em article on structured tags) (opcional)
extra (object): campo utilizado para filtragens de produto onde não é permitida a coleta de opiniões (informar nossa equipe) (opcional)
seller (object): dados sobre o seller em caso de marketplace
id (string): identificador único do seller (obrigatório)
name (string): nome do seller (obrigatório)
logo (string): logotipo do seller (opcional)
tags (array of strings): trata-se de um array de strings sobre o pedido como um todo (Ex.: "Origem/LojaFisica", leia mais em article on structured tags) (opcional)
Segue um exemplo em cURL:
Esta requisição precisa ser feita para cada novo pedido finalizado/entregue pela empresa.
Com este a TrustVox receberá um(ou mais) pedidos na base deles e na sequência vão coletar opiniões via e-mail, com base nos dados informados no payload da requisição (pedido).
Sugerimos entrar em contato com a equipe da TrustVox para validarem se os pedidos encaminhados chegaram até a base deles.
No Link abaixo você fará a implementação das ferramentas visuais em seu Front-end de seu site.
Passo 4 - Acessar esse Link
Passo 5 - No Menu clicar em Integrar
Desça a barra de rolagem até TrustVox e clique no botão Configurar
Preencha o campo Informações com o StoreId e o StoreToken fornecidos pela TrustVox.
Atualizado em: 06/07/2023
Obrigado!