Stripe Tools - NicoApp

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

Instalação e Configuração do NicoApp

Para fazer requisições via API, primeiro é necessário ter sua chave de autentiação (secret key). Para obter sua chave, vá em: https://dashboard.stripe.com/apikeys

Instalando o NicoApp

Acesse a seção "NicoApps" no NicoChat.
Selecione e instale a versão mais recente disponível para Stripe (ex.: 1.1, 1.2).

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

Configurando o NicoApp

Clique em Criar chave secreta

2. Nomeie sua chave de API e clique em criar

Copie a chave de API gerada

Configurando o Webhook

Em "Tools" ou "Ferramentas", acesse "Webhooks de Entrada". Crie um novo Webhook nomeando-o como "Stripe"

Crie um novo Webhook nomeando-o como "Stripe" 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, '');
if (telefone.startsWith('+55') || telefone.startsWith('55') || (telefone.startsWith('+') && !telefone.startsWith('+55'))) {
return whatsapp;
}
const ddi = "55";
let ddd;
if (whatsapp.length === 10 || whatsapp.length === 11) {
ddd = whatsapp.slice(0, 2);
whatsapp = whatsapp.slice(2);
if (parseInt(ddd, 10) <= 28) {
whatsapp = '9' + whatsapp.slice(-8);
} else {
whatsapp = whatsapp.slice(-8);
}
return ddi + ddd + whatsapp;
}
return whatsapp;
}
if (payload.data.object.customer_phone) {
return {
"name": payload.data.object.customer_name,
"email": payload.data.object.customer_email,
"phone": formatarTelefone(payload.data.object.customer_phone),
"body": payload
};
} else {
throw new Error('Telefone do usuário não foi 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)

Após as edições copie o URL fornecido. Após isso acesse: https://dashboard.stripe.com/webhooks/create e siga o passo a passo.

Cole a URL no campo indicado
Mantenha sempre a versão atual já fornecida na ferramenta
Selecione os eventos que você necessita dentro da Stripe

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

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:

Uso prático do NicoApp