Logzz

Neste artigo você vai conferir:

O passo a passo para integrar o Chatzz com a Logzz
Como visualizar, editar ou excluir a integração criada
Notificação de conversão
Lista de parâmetros de requisição para integração

⚠️Antes do passo a passo de como integrar o Chatzz e Logzz, confira abaixo a tabela que detalha os campos obrigatórios para fazer a integração:

TABELA COM CAMPOS OBRIGATÓRIOS PARA INTEGRAÇÃO

Campo	Valor a ser mapeado
Evento	order_status
Nome	client_name
Telefone	cliente_phone

1 - PASSO A PASSO PARA INTEGRAR O CHATZZ COM A LOGZZ

Passo 1 - No menu do Chatzz, clique em "Integrações".

Passo 2 - Clique em "+ Nova Integração".

Passo 3 - Insira os dados gerais para sua integração.

Determine um nome para sua integração e selecione a Logzz como plataforma de integração.

Passo 4 - Clique em "Continuar".

Passo 5 - Copie o link disponibilizado.

Será disponibilizado um link para você inserir na Logzz. Copie este link, clicando em "Copiar".

Passo 6 - Acesse a Logzz, clique em "Integrações" e, em seguida, em "Webhook".

Passo 7 - Clique em "Nova integração".

Passo 8 - Insira as informações necessárias para cadastrar o webhook, sendo:

a) Nome da Integração: Defina um nome para a integração.

b) Link do WebHook: Insira o link copiado do Chatzz no passo 5.

c) Selecione o produto.

d) Selecione o status.

Defina se o disparo será realizado para vendas que possuírem afiliados e se o webhook será disparado.

Passo 9 - Clique em "Cadastrar".

Passo 10 - Com a sua integração cadastrada na Logzz, encontre ela na lista de webhook e clique em "Testar".

Aguarde a confirmação da integração.

Passo 11 - Volte para o Chatzz e clique em "Continuar".

Passo 12 - Defina os campos e valores a serem mapeados obrigatoriamente.

Campo	Valor a ser mapeado da Logzz
Evento	order_status
Nome	client_name
Telefone*	cliente_phone

⚠️*Em telefone, além de adicionar o valor a ser mapeado, é necessário determinar o DDI (Discagem Direta Internacional), no caso do Brasil o DDI é 55.

Clique aqui para conferir todos os parâmetros de integração da Logzz

Para adicionar mais campos, clique em "+ adicionar campos". Selecione o campo desejado e o valor a ser mapeado.

Exemplo: Campo - Quantidade de produto | Valor a ser mapeado - order_quantity

Quando finalizar a adição dos campos, clique em "Concluir".

Depois de seguir os passos acima, sua integração estará finalizada. Clique em "Fechar".

2 - COMO VISUALIZAR, EDITAR OU EXCLUIR A INTEGRAÇÃO CRIADA NO CHATZZ

Para visualizar sua integração criada no Chatzz, vá até "Integrações" e localize a integração criada. Ao clicar nos três pontinhos da integração, aparecerão as opções de:

a) Visualizar: Ao clicar nessa opção, serão exibidos a estrutura de dados e o histórico dos eventos.

b) Editar: Altere o nome da integração e/ou a plataforma.

c) Excluir: Para exclusão de integração criada.

3 - NOTIFICAÇÃO DE CONVERSÃO

3.1 Configurando as notificações

As notificações de conversão são os eventos que a plataforma, no caso deste artigo a Logzz, envia para você poder utilizar como gatilho para suas automações.

Para configurar esses eventos, que são os gatilhos, siga os passos abaixo:

Passo 1 - Em "Integrações", clique em "Notificações de conversão".

Passo 2 - Localize a integração e na coluna "Ações", clique no símbolo de lápis.

Passo 3 - Clique em "+ Novo evento".

Passo 4 - Insira o nome e a identificação do evento.

A identificação é como o evento será identificado no campo de evento mapeado, no caso da Logzz o valor do evento mapeado é order_status e a identificação do evento é uma das opções da planilha abaixo:

Identificação dos eventos	Descrição
Agendado	Sempre que um formulário de agendamento é preenchido ao solicitar uma entrega, o pedido entrará na Logzz com o status Agendado
Reagendado	Esse status indica que houve uma alteração na data de entrega do seu pedido.
Completo	Significa que seu cliente recebeu e pagou pelo produto enviado.
Frustrado	Esse status indica que houve uma tentativa de entrega do seu pedido no endereço cadastrado porém sem sucesso de recebimento.
Cancelado	Esse status indica que seu pedido foi cancelado e não será entregue.
Reembolsado	Indica que o pedido completo sofreu alteração para "Reembolsado" por solicitação do cliente, onde dentro do período de garantia ele entrou em contato com a equipe de trocas e reembolsos e demonstrou arrependimento ou insatisfação com o produto.
A reagendar	Significa que a entrega do pedido será reagendada.
Em separação	Que o pedido está em processo de separação e embalagem.
Em rota	Significa que a entregas foi distribuída para time logístico.
A caminho	Esse status indica que a entrega daquele pedido será a próxima dentro da rota do entregador responsável. Ou seja, em poucos minutos o pedido será entregue.

Exemplo:

Nome: Pedido agendado

Identificação: Agendado

3.2 Configurando ações

Depois de criar o evento, é necessários configurar as ações deste evento.

Passo 1 - Clique em "Configurar ações".

Passo 2 - Clique em "+Nova ação".

Passo 3 - Selecione a(s) ação(ões).

a) Ações cumulativas
Permitem que você adicione mais que uma e todas elas serão executadas quando o evento configurado for disparado. As ações cumulativas são:

Adicionar etiqueta: para marcar o lead com uma etiqueta e facilitar a identificação.
Remover etiqueta: para retirar a etiqueta do lead.
Atualizar campo personalizado: para registrar informações do lead.

b) As ações de envio

São ações relacionadas ao envio de mensagens e que permite apenas selecionar uma entre as opções:

Enviar chatbot: Para disparar um fluxo
Mensagem personalizada: Para enviar uma mensagem personalizada, que deve ser digitada.
Enviar resposta rápida: Para selecionar uma resposta rápida para ser disparada.

⚠️Você só pode ter uma ação de disparo de mensagens por evento.

Passo 4 - Clique em "Salvar".

4 - LISTA DE PARÂMETROS DE REQUISIÇÃO PARA INTEGRAÇÃO

Parâmetro	Descrição	Formato
Informações do Cliente
`client_name`	Nome completo do cliente	String
`client_email`	Email do cliente (caso tenha solicitado)	String ou `null`
`client_documment`	Documento do cliente (CPF ou CNPJ)	String ou `null`
`client_phone`	Telefone do cliente	String
`client_zip_code`	CEP do cliente	String
`client_address`	Endereço do cliente	String
`client_address_number`	Número do endereço	String
`client_address_district`	Bairro do endereço	String
`client_address_comp`	Complemento do endereço	String
`client_address_city`	Cidade do endereço	String
`client_address_state`	Estado do endereço	String
`client_address_country`	Pais do endereço	String
Informações do pedido
`order_number`	Código pedido	String
`date_order`	Data do pedido	"yyyy-mm-dd H:i:s"
`date_order_day`	Data do pedido (dia)	String
`date_delivery`	Data de entrega	"yyyy-mm-dd H:i:s"
`date_delivery_day`	Dia da semana da entrega	String
`delivery_estimate`	Estimativa de entrega	String
`order_status`	Status do pedido	String \| Status disponíveis: "Agendado", "Reagendado", "Completo", "Frustrado", "Cancelado", "Reembolsado", "A reagendar", "Em separação", "Em rota", "A caminho"
`order_status_description`	Descrição do status do pedido	String or `null`
`order_quantity`	Quantidade de items do produto principal	Integer
`order_final_price`	Preço total do pedido	Float
Informações dos Produtos
`products`	Contém os produtos do pedido	Array de arrays
`products.main`	Contém informações do produto principal	Array
`products.main.product_name`	Nome do produto	String
`products.main.product_code`	Código do produto	String
`products.main.quantity`	Quantidade do produto	Inteiro
`products.main.variations`	Contém informações do produto principal	Array ou `null`
`products.principal.product_name`	Nome do produto	String
`products.principal.variation_names`	Nome da variação	String
`products.principal.product_code`	Código do produto	String
`products.principal.quantity`	Quantidade do produto	Inteiro
`products.order_bumps`	Contém informações do produto principal	Array
`products.order_bumps.product_name`	Nome do produto	String
`products.order_bumps.product_code`	Código do produto	String
`products.order_bumps.quantity`	Quantidade do produto	String
Informações dos usuários
`logistic_operator`	Nome do gerente do armazém	String ou `null`
`delivery_man`	Nome do entregador que irá/realizou a entrega	String ou `null`
`delivery_man_phone`	Telefone do entregador que irá/realizou a entrega	String ou `null`
`producer_name`	Nome do produtor	String
`producer_email`	Email do produtor	String
`affiliate_name`	Nome do afiliado	String ou `null`
`affiliate_email`	Email do afiliado	String ou `null`

Abaixo confira o exemplo de envio dos dados pelo webhook

/** Exemplo do envio dos dados pelo webhook */
{
  "client_name": "John Doe",
  "client_email": [email protected],
  "client_documment": "123.456.789-00",
  "client_phone": "+5511123456789",
  "client_zip_code": "01001-000",
  "client_address": "Praça da Sé",
  "client_address_number": "139",
  "client_address_district": "Sé",
  "client_address_comp": "Lado ímpar",
  "client_address_city": "São Paulo",
  "client_address_state": "SP",
  "client_address_country": "Brasil",
  "date_order": "1000S0123P1000",
  "date_order_day": "2023-11-21 11:26:11",
  "date_delivery": "terça-feira",
  "date_delivery_day": "2023-11-22 00:00:00",
  "delivery_estimate": "quarta-feira",
  "order_number": null,
  "order_status": "Agendado",
  "order_status_description": "",
  "order_quantity": 2,
  "order_final_price": "50.00",
  "products": {
    "main": {
       "product_name": "pote genérico",
       "product_code": "KNEQuh",
       "quantity": 2
       "variations": [
        {
         "product_name": "pote genérico-Branco",
         "variation_names": "Cor: Branco",
         "product_code": "KNEQuh-1",
         "quantity": 1
        },
        {
         "product_name": "pote genérico-Preto",
         "variation_names": "Cor: Preto",
         "product_code": "KNEQuh-2",
         "quantity": 1
        }
      ]
    }
  },
  "logistic_operator": "Logistics Inc.",
  "delivery_man": "John Courier",
  "delivery_man_phone": "+5511987654321",
  "producer_name": "Producer Corp.",
  "producer_email": "[email protected]",
  "affiliate_name": null,
  "affiliate_email": null
}