⚠️Antes do passo a passo de como integrar o Chatzz e Ticto, 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 | status |
Nome | customer.name |
Telefone* | customer.phone.number |
DDD | customer.phone.ddd |
1 - PASSO A PASSO PARA INTEGRAR O CHATZZ COM A TICTO.
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 Ticto como plataforma de integração.
Passo 4 - Clique em "Continuar".
Passo 5 - Copie o link disponibilizado.
Será disponibilizado um link para você inserir na Ticto. Copie este link, clicando em "Copiar".
Passo 6 - Acesse a Ticto, clique em "Tictools" e, em seguida, em "Webhook".
Passo 7 - Clique em "+ Adicionar".
Passo 8 - Insira as informações necessárias para cadastrar o webhook, sendo:
a) Selecionar entre "Enviar Order Bump junto com a oferta principal" ou "Enviar Order Bump separadamente".
b) Selecionar o produto.
b) Link do WebHook: Insira o link copiado do Chatzz no passo 5.
c) Selecione uma versão - Escolha a versão 2.0 (recomendável).
d) Selecione o formato do envio: O formado do envio deve ser JSON
e) Selecione os eventos que deseja enviar no webhook.
Passo 9 - Clique em "Salvar"
Passo 10 - Na lista de Webhook, encontre o Webhook criado e clique em "Ações" e, em seguida, clique em "Enviar teste de envio".
Passo 11 - Faça a confirmação.
Aguarde a confirmação.
Passo 11 - Volte para o Chatzz e clique em "Continuar".
Passo 12 - Defina os campos e valores a serem mapeados obrigatoriamente, sendo:
Campo | Valor a ser mapeado |
Evento | status |
Nome | customer.name |
Telefone* | customer.phone.number |
DDD | customer.phone.ddd |
⚠️*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.
Para adicionar mais campos, clique em "+ adicionar campos". Selecione o campo desejado e o valor a ser mapeado.
Exemplo: E-mail do cliente | Valor a ser mapeado - customer.email
Para criar um campo personalizado, clique em "+Criar campo personalizado". Adicione o nome do campo e a descrição do campo. Em seguida clique em "Criar".
Exemplo: Campo - Nome do Produto | Valor a ser mapeado - item.product_name
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) Mapeamento: Nesta opção, será possível visualizar os campos mapeados para a integração e também a opção de "Mapear Campos". Ao clicar nela, um novo mapeamento da integração pode ser realizado.
d) 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 Ticto, 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 Ticto o valor do evento mapeado é status e a identificação do evento é uma das opções da planilha abaixo:
Evento: status | Descrição |
authorized | Compra Aprovada |
refused | Compra negada no cartão |
delayed | Boleto atrasado |
refunded | Reembolso Efetuado |
blocked | Bloqueio de Anti-Fraude |
expired | Boleto ou pix vencido |
abandoned_cart | Abandono de Carrinho |
trial | Período de Testes |
waiting_payment | Aguardando Pagamento |
subscription_canceled | Assinatura Cancelada |
⚠️Os critérios de identificação de evento e a descrição deles é particular de cada plataforma. Consulte sempre o Webhook da plataforma que deseja integrar com o Chatzz.
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 DA VERSÃO 2.0
Nome do parâmetro | Enviado para Afiliado ou Coprodutor | Descrição | Formato e tamanho suportado |
commission_type | Sim | Tipo de comissão do postback | Possíveis valores |
status | Sim | Status da compra | Possíveis valores |
payment_method | Sim | Forma de pagamento do comprador | Possíveis valores |
order.hash | Sim | Código do pedido | Números e letras de até 255 caracteres |
order.paid_amount | Sim | Preço da oferta no momento da compra | inteiro |
order.installments | Sim | Quantidade de Parcelas | Número com até 2 dígitos |
bumps | Sim | Order Bumps (Só será enviado caso o produtor deseje enviar os bumps junto com o produto principal) | Array de Objetos |
bumps[indice].product_name | Sim | Nome do Produto | (string) |
bumps[indice].offer_id | Sim | ID da Oferta | Número com até 2 dígitos |
bumps[indice].offer_name | Sim | Nome da Oferta | (string) |
bumps[indice].offer_price | Sim | Valor da Oferta | Inteiro (centavos) |
bumps[indice].refund_deadline | Sim | Prazo de reembolso do produto | Inteiro |
bumps[indice].product_support_email | Sim | Email de suporte do produto | (string) |
bumps[indice].product_support_phone | Sim | Telefone de suporte do produto | (string) |
freight.amount | Sim | Valor do Frete | Inteiro (centavos) |
freight.type | Sim | Tipo de Frete | Possíveis valores |
freight.method | Sim | Método de Envio | Possíveis valores |
item.product_name | Sim | Nome do produto | Números e letras de até 255 caracteres |
item.product_id | Sim | ID do Produto | Número com até 20 dígitos |
item.offer_name | Sim | Nome do produto que foi adquirido | Números e letras de até 255 caracteres |
item.offer_id | Sim | Identificador da oferta que foi adquirida | Números e letras de até 255 caracteres |
item.refund_deadline | Sim | Prazo de reembolso do produto | inteiro |
item.coupon_id | Sim | Id do cupom (se utilizado) | Números e letras de até 255 caracteres |
item.coupon_name | Sim | Nome do cupom (se utilizado) | Números e letras de até 255 caracteres |
item.quantity | Sim | Quantidade de itens da oferta | inteiro |
item.amount | Sim | Preço da unidade da oferta | inteiro |
item.members_portal_id | Sim | Identificador do portal de membros | inteiro |
item.members_classroom_id | Sim | Identificador da classe de membros | inteiro |
item.days_of_access | Sim | Dias de acesso à área de membros | inteiro |
item.trial_days | Sim | País | Letras 2 digitos. |
subscriptions | Sim | Assinaturas atreladas à venda | Array de objetos |
subscriptions[indice].id | Sim | Código identificador da assinatura | Inteiro |
subscriptions[indice].interval | Sim | Intervalo entre cobranças (Ex: 1 para um mês, 2 para dois meses, etc.) | Inteiro |
subscriptions[indice].successful_charges | Sim | Quantidade de cobranças pagas | Inteiro |
subscriptions[indice].failed_charges | Sim | Quantidade de tentativas falhas | Inteiro |
subscriptions[indice].max_charges | Sim | Quantidade máxima de cobranças (se vazio, a assinatura é renovada automaticamente) | Inteiro |
subscriptions[indice].next_charge | Sim | Data da próxima cobrança (se vazio, a assinatura está cancelada) | Datetime - Ex.: YYYY-MM-DD HH:MM:SS |
subscriptions[indice].canceled_at | Sim | Data de cancelamento (se vazio, a assinatura está ativa) | Datetime - Ex.: YYYY-MM-DD HH:MM:SS |
transaction.hash | Sim | Código de identificação da transação | Números e letras de até 255 caracteres |
transaction.cards | Não | Array de cartões utilizados na compra (somente se for cartão) | Array |
transaction.cards[indice].brand | Não | Bandeira do Cartão | (string) |
transaction.cards[indice].holder | Não | Nome no Cartão | (string) |
transaction.cards[indice].first_digits | Não | 6 Primeiros Dígitos do Cartão | (string) |
transaction.cards[indice].last_digits | Não | 4 últimos dígitos do Cartão | (string) |
transaction.bank_slip_code | Sim | Código identificador de boleto (somente se for boleto) | (string) |
transaction.bank_slip_url | Sim | URL de download de boleto (somente se for boleto) | (string) |
transaction.pix_qr_code | Sim | Código de pagamento do pix (somente se for pix) | (string) |
customer.cpf | (Depende da configuração do produto de compartilhar informações) | CPF do comprador | (string) |
customer.cnpj | (Depende da configuração do produto de compartilhar informações) | CNPJ do comprador | (string) |
customer.name | (Depende da configuração do produto de compartilhar informações) | Nome completo do comprador | (string) |
customer.type | (Depende da configuração do produto de compartilhar informações) | Tipo jurídico do comprador | "person" ou "company" |
customer.email | (Depende da configuração do produto de compartilhar informações) | E-mail do comprador | (string) |
customer.is_foreign | (Depende da configuração do produto de compartilhar informações) | Boolean se o comprador é estrangeiro ou não | (boolean) |
phone_number_customer | (Depende da configuração do produto de compartilhar informações) | Número do telefone | Números e letras de até 20 caracteres - Ex.: 99999999 |
customer.phone.ddd | (Depende da configuração do produto de compartilhar informações) | DDD do comprador | Números e letras de até 255 caracteres (string) |
customer.phone.ddi | (Depende da configuração do produto de compartilhar informações) | DDI do comprador | Números e letras de até 255 caracteres (string) |
customer.phone.number | (Depende da configuração do produto de compartilhar informações) | Number do comprador | Números e letras de até 255 caracteres (string) |
customer.address.street | (Depende da configuração do produto de compartilhar informações) | Rua ou avenida do comprador | Números e letras de até 255 caracteres (string) |
customer.address.street_number | (Depende da configuração do produto de compartilhar informações) | Número de residencia do comprador | Números e letras de até 255 caracteres (string) |
customer.address.complement | (Depende da configuração do produto de compartilhar informações) | Complemento de residência do comprador | Números e letras de até 255 caracteres (string) |
customer.address.neighborhood | (Depende da configuração do produto de compartilhar informações) | Bairro do comprador | Números e letras de até 255 caracteres (string) |
customer.address.city | (Depende da configuração do produto de compartilhar informações) | Cidade do comprador | Números e letras de até 255 caracteres (string) |
customer.address.state | (Depende da configuração do produto de compartilhar informações) | Estado do comprador | Números e letras de até 255 caracteres (string) |
customer.address.zip_code | (Depende da configuração do produto de compartilhar informações) | CEP do comprador | Números e letras de até 255 caracteres (string) |
commission | Enviado SOMENTE para afiliados e coprodutores | Produtor atrelado à venda | Objeto |
commission.id | Enviado SOMENTE para afiliados e coprodutores | Código Identificador do Produtor | Inteiro |
commission.name | Enviado SOMENTE para afiliados e coprodutores | Nome do Produtor | (string) |
commission.email | Enviado SOMENTE para afiliados e coprodutores | Email do Produtor | (string) |
commission.amount | Enviado SOMENTE para afiliados e coprodutores | Comissão do Produtor | Inteiro (centavos) |
producer | Não | Produtor atrelado à venda | Objeto |
producer.id | Não | Código Identificador do Produtor | Inteiro |
producer.name | Não | Nome do Produtor | (string) |
producer.email | Não | Email do Produtor | (string) |
producer.document | Não | CPF ou CNPJ do produtor | (string) |
producer.amount | Não | Comissão do Produtor | Inteiro (centavos) |
affiliates | Não | Afiliados atrelados à venda | Array de objetos |
affiliates[indice].id | Não | Código Identificador do Afiliado | Inteiro |
affiliates[indice].name | Não | Nome do Afiliado | (string) |
affiliates[indice].email | Não | Email do Afiliado | (string) |
affiliates[indice].document | Não | CPF ou CNPJ do Afiliado | (string) |
affiliates[indice].amount | Não | Comissão do Afiliado | Inteiro (centavos) |
coproducers | Não | Coprodutores atrelados à venda | Array de objetos |
coproducers[indice].id | Não | Código Identificador do Coprodutor | Inteiro |
coproducers[indice].name | Não | Nome do Coprodutor | (string) |
coproducers[indice].email | Não | Email do Coprodutor | (string) |
coproducers[indice].document | Não | CPF ou CNPJ do Coprodutor | (string) |
coproducers[indice].amount | Não | Comissão do Coprodutor | Inteiro (centavos) |
marketplace_commission | Não | Comissão da Ticto | Inteiro (centavos) |
query_params | Sim | Parâmetros da URL no ato da compra | Objeto: {label:value} |
tracking | Sim | Trackeamento de campanhas (utm). Se não possuir valor, será enviado "Não Informado" | Objeto: |
Confira abaixo o exemplo de envio dos dados pelo webhook da Ticto
{
"status": "authorized",
"status_date": "2022-03-23 14:28:22",
"payment_method": "bank_slip",
"commission_type": "producer",
"order": {
"order_date": "2022-03-23 14:28:22",
"hash": "TOB12609GU88Q5",
"paid_amount": 50000,
"installments": 1
},
"freight": {
"amount": 1000,
"type": "shipping_company",
"method": "pac",
},
"item": {
"product_name": "Paki Guthrie",
"product_id": 1,
"offer_name": "Teste qa",
"refund_deadline": 7,
"offer_id": 16,
"coupon_id": null,
"coupon_name": null,
"quantity": 1,
"amount": 50000,
"members_portal_id": 24,
"members_classroom_id": 123,
"days_of_access": null,
"trial_days": null
},
"subscriptons": [
{
"id": 1,
"interval": 1,
"next_charge": "2023-12-01 00:00:00",
"successful_charges": 1,
"failed_charges": 0,
"max_charges": "",
"canceled_at": "",
},
{
"id": 2,
"interval": 1,
"next_charge": "",
"successful_charges": 6,
"failed_charges": 0,
"max_charges": 6,
"canceled_at": "2023-12-01 00:00:00",
}
],
"transaction": {
"hash": "TPCMA2102N0999965214CAK",
"bank_slip_code": "03399.85301 29700.000242 2722020.901016 2 7815002200015630",
"bank_slip_url": "https://checkout.ticto.com.br/bank_slip/f92e014a-b80c-4b0e-94a1-eb8811e991de.pdf",
"pix_qr_code": "00020101021226850014br.gov.bcb.pix2563api-h.ticto.com/pix/v2/E926FFDA-D47E-4590-A183-D6C05071670F27600016BR.COM.ticto0136E926FFDA-D47E-4590-A183-D6C05071670F520479945303986540810000.005802BR5921TICTO TECNOLOGIA LTDA6008CAMPINAS62070503***6304A6B6",
"cards": [
{
"brand": "visa",
"holder": "Teste de Nome aqui",
"first_digits": "411111",
"last_digits": "1111"
}
]
},
"customer": {
"cpf": "00442742299",
"cnpj": null,
"name": "Cliente Teste",
"type": "person",
"email": "[email protected]",
"is_foreign": false,
"phone_number_customer": "1199999999",
"phone": {
"ddd": "999",
"ddi": "+55",
"number": "995682466"
},
"address": {
"street": "Rua teste",
"street_number": "222",
"complement": "Complemento Teste",
"neighborhood": "Teste de Bairro",
"city": "São Paulo",
"state": "SP",
"zip_code": "13044207"
}
},
"producer": {
"id": 1,
"name": "Nome do Produtor",
"email": "[email protected]",
"document": "00000000000",
"cms": 80
},
"affiliates": [
{
"id": 1,
"name": "Nome do Afiliado 1",
"email": "[email protected]",
"document": "00000000000",
"amount": 40
},
{
"id": 2,
"name": "Nome do Afiliado 2",
"email": "[email protected]",
"document": "00000000000",
"amount": 40
}
],
"coproducers": [
{
"id": 1,
"name": "Nome do coprodutor 1",
"email": "[email protected]",
"document": "00000000000",
"amount": 40
},
{
"id": 2,
"name": "Nome do coprodutor 2",
"email": "[email protected]",
"document": "00000000000",
"cms": 40
}
],
"query_params": {
"code": "ODBB073D9",
"sck": "REMARKETING"
},
"tracking": {
"utm_source": "Não Informado",
"utm_medium": "Não Informado",
"utm_campaign": "Não Informado",
"utm_content": "Não Informado",
"utm_term": "Não Informado",
"src": "Não Informado",
"sck": "REMARKETING"
}
}