Introdução

Bem-vindo ao guia de integração do NicoChat com o mini app da Greenn. Esta documentação fornece um passo a passo detalhado sobre como configurar e utilizar as funcionalidades do NicoChat junto com a Greenn. A integração automatiza interações através de ações de Checkout via Webhook, processa dados e gerencia comunicações de forma eficiente.

Instalação e Configuração do NicoApp

Obtendo as Credenciais

Para fazer requisições via Webhook, primeiro é necessário ter seu Token de Webhook. Para obter seu token, vá em: Configurações do Sistema > Integrações e Tokens.

Instalando o NicoApp

1. Acesse a seção "NicoApps" no NicoChat.

2. Selecione e instale a versão mais recente disponível para Greenn (ex.: 1.1, 1.2).

3. Configurar Credenciais no NicoChat:

No NicoChat, cole as credenciais copiadas nos campos apropriados e salve.

Configuração de Webhooks

Criar Webhook no NicoChat

Em "Tools" ou "Ferramentas", acesse "Webhooks de Entrada".

Crie um novo Webhook nomeando-o como "Green" e copie o URL fornecido.

Clique em “Editar”, ative o “Pré-processamento de dados” e insira o código abaixo:

function firstName(nomeCompleto){
    const parts = nomeCompleto.split(' ');
    const first_name = parts[0];
    return first_name
}

function lastName(nomeCompleto){
    const parts = nomeCompleto.split(' ');
    let last_name = parts.slice(1).join(' ') || '';
    return last_name
}

function formatarTelefone(telefone){
    let whatsapp = telefone.replace(/\D/g, '')
    const ddi = "55";
    let ddd;
    if (whatsapp.startsWith("55")) {
        whatsapp = whatsapp.slice(2);
    }
    if (whatsapp.length >= 10) {
        ddd = whatsapp.slice(0, 2);
        whatsapp = whatsapp.slice(2);
    } else {
        ddd = '00';
    }
    if (ddd !== '00' && parseInt(ddd, 10) <= 28) {
        whatsapp = '9' + whatsapp.slice(-8);
    } else {
        whatsapp = whatsapp.slice(-8);
    }
    const whatsapp_formatado = ddi + ddd + whatsapp;
    return whatsapp_formatado
}

if (payload.client) {

return {"name":payload.client.name,"email":payload.client.email,"phone":formatarTelefone(payload.client.cellphone),"body":payload};

} else {

throw new Error('Email não encontrado no payload.');

}

Depois clique em “Pré-visualizar Payload” mapeie os campos de Email, Phone e Webhook Body conforme abaixo:

Caminho JSON: $.phone => Resposta do mapa ao campo: Phone (Clique em adicionar)

Caminho JSON: $.email => Resposta do mapa ao campo: Email (Clique em adicionar)

Caminho JSON: $.name => Resposta do mapa ao campo: First Name (Clique em adicionar)

Caminho JSON: $.body => Resposta do mapa ao campo: {{variável JSON para armazenar o corpo do Webhook}} (Clique em adicionar)

Crie um subfluxo no NicoChat, insira um bloco de ação e selecione Integrações > greenn

Depois selecione “Webhook” e insira o JSON de “webhook body” criado anteriormente. Depois Salve.

Depois volte em Ferramentas > Webhooks de Entrada e selecione o fluxo criado:

Registrando Webhook na greenn

Os webhooks são configurados individualmente para cada produto registrado. Para configurar um webhook em um produto específico, siga estes passos: Acesse 'Produtos' > 'Editar Produto' > 'Conteúdos'.

Clique em 'Adicionar conteúdo' e, em seguida, selecione 'Sistema externo', depois 'Entrega via webhook'.

Para habilitar a captura de eventos específicos via Webhook no NicoChat, siga estas etapas:

1. Habilitação de Eventos: Habilite os eventos que deseja registrar para notificação via Webhook.

2. URL do Webhook: Forneça a URL de requisição do Webhook do NicoChat, onde os eventos serão enviados.

3. Criação de Liberação: Após configurar os eventos e a URL do Webhook, clique no botão "Cria Liberação" para ativar a integração.

Depois de criar a liberação dos eventos, os Webhooks serão configurados individualmente, cada um recebendo um nome que descreve sua função específica. O botão azul com o símbolo (⚡) corresponde à opção para testar a chamada do evento.

Uso prático do NicoApp

Crie um fluxo no canal onde o Webhook foi configurado e selecione os gatilhos de ativação do fluxo de acordo com os eventos escolhidos na Liberação de Eventos pela Greenn.

Agradecemos por escolher o NicoChat para a integração com a Greenn, e esperamos que este guia facilite a configuração e melhore a eficiência de suas operações. Até a próxima!