Integrações/NicoApps (MiniApps) Nativos/Gateway Pagamento (NicoApps)/Assas

Assas

A integração do sistema Asaas com o NicoChat representa uma nova era na automação de cobranças e gestão financeira para negócios de todos os tamanhos. Com a API Key do Asaas, o Nic

2026-08-11

Introdução

A integração do sistema Asaas com o NicoChat representa uma nova era na automação de cobranças e gestão financeira para negócios de todos os tamanhos. Com a API Key do Asaas, o NicoChat transforma o complexo cenário de pagamentos e recebimentos em um processo fluído e eficiente. Esta integração capacita as empresas a cobrar via boleto, Pix, crédito, débito, link de pagamento e de forma recorrente, quando necessário, diretamente através do chat. O Asaas não é apenas uma plataforma de pagamentos, mas um verdadeiro assistente financeiro digital, oferecendo gestão de assinaturas, cofre de cartão de crédito, antecipação de recebíveis e muito mais.

Vídeo no YouTube (indisponível para incorporação)

Configuração do Asaas

Obtenção da API Key:

Acesse o dashboard do Asaas e obtenha sua API Key para conectar com o NicoChat.

Conhecendo os Limites da API:

Familiarize-se com os limites de solicitações, cota de uso e requisições concorrentes para garantir o bom funcionamento e desempenho da integração.

Ações Disponíveis

Financeiro

Contas:
Criar um pagamento de conta (CREATE): Automatize o pagamento de contas da sua empresa.Transferir para conta de outra Instituição (CREATE): Envie fundos para contas em outras instituições financeiras.Transferir via PIX (CREATE): Realize transferências instantâneas utilizando o sistema PIX.

Gestão de Chaves

Chaves PIX:
Criar uma chave (CREATE): Registre uma nova chave PIX para sua conta.Listar chaves (READ): Obtenha uma lista das suas chaves PIX.Remover chave (DELETE): Delete uma chave PIX que não será mais utilizada.

Clientes

Gerenciamento de Clientes:
Criar novo cliente (CREATE): Adicione clientes ao seu banco de dados do Asaas.Listar clientes (READ): Visualize clientes baseados em CPF/CNPJ ou nome.Atualizar cliente existente (CREATE): Atualize informações de clientes já cadastrados.Remover cliente (DELETE), Restaurar cliente removido (READ): Gerencie o ciclo de vida dos registros dos clientes.

Cobranças

Processo de Cobrança:
Crie, atualize, exclua e restaure cobranças.Confirme recebimentos em dinheiro e estorne cobranças quando necessário.Filtrar cobranças por diferentes critérios, como data, forma de pagamento e status.Recupere informações detalhadas de cobranças específicas.

Extrato e Saldo

Informações Financeiras:
Recuperar extrato (READ): Acesse o histórico de transações da sua conta.Recuperar saldo da conta (READ): Verifique o saldo atual disponível.

Exemplos Práticos

Criar Nova Cobrança:

Ao registrar uma venda no NicoChat, automaticamente crie uma cobrança no Asaas utilizando a ação "Criar nova cobrança à vista" com os detalhes da transação fornecidos pelo cliente.

Gestão de Assinaturas:

Use "Listar clientes por CPF ou CNPJ" para verificar se um cliente é um assinante existente e "Atualizar cobrança existente" para modificar os termos de uma assinatura ativa.

Recuperação de Saldo:

Antes de realizar pagamentos ou transferências, utilize "Recuperar saldo da conta" para garantir fundos suficientes.

Ao seguir estas diretrizes e exemplos, a integração com o Asaas no NicoChat permitirá que você gerencie todas as nuances financeiras do seu negócio de forma automatizada e segura. Essa integração promete não só simplificar procedimentos complexos, mas também contribuir para a redução da inadimplência e o fortalecimento do fluxo de caixa da empresa.

Webhook

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:

javascript

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, '');
    //Adicione aqui exceções de DDi que não devem receber o tratamento do Script
    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.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.');

}