Integrations/NicoApps (MiniApps) Nativos/Payment Gateway (NicoApps)/Asaas

Asaas

2026-08-12

Introduction

The integration of the Asaas system with NicoChat represents a new era in billing automation and financial management for businesses of all sizes. With the Asaas API Key, NicoChat turns the complex landscape of payments and receivables into a smooth and efficient process. This integration enables companies to charge via bank slip, Pix, credit, debit, payment link and on a recurring basis, when needed, directly through the chat. Asaas is not just a payment platform, but a true digital financial assistant, offering subscription management, credit card vault, receivables anticipation and much more.

Video on YouTube (unavailable for embedding)

Asaas Configuration

Getting the API Key:

Go to the Asaas dashboard and get your API Key to connect with NicoChat.

Understanding the API Limits:

Familiarize yourself with the request limits, usage quota and concurrent requests to ensure the proper functioning and performance of the integration.

Available Actions

Finance

Accounts:
Create a bill payment (CREATE): Automate the payment of your company's bills. Transfer to an account at another Institution (CREATE): Send funds to accounts at other financial institutions. Transfer via PIX (CREATE): Make instant transfers using the PIX system.

Key Management

PIX Keys:
Create a key (CREATE): Register a new PIX key for your account. List keys (READ): Get a list of your PIX keys. Remove key (DELETE): Delete a PIX key that will no longer be used.

Customers

Customer Management:
Create new customer (CREATE): Add customers to your Asaas database. List customers (READ): View customers based on CPF/CNPJ or name. Update existing customer (CREATE): Update information for customers already registered. Remove customer (DELETE), Restore removed customer (READ): Manage the life cycle of customer records.

Charges

Charging Process:
Create, update, delete and restore charges. Confirm payments received in cash and refund charges when necessary. Filter charges by different criteria, such as date, payment method and status. Retrieve detailed information about specific charges.

Statement and Balance

Financial Information:
Retrieve statement (READ): Access your account's transaction history. Retrieve account balance (READ): Check the current available balance.

Practical Examples

Create New Charge:

When you register a sale in NicoChat, automatically create a charge in Asaas using the "Criar nova cobrança à vista" action with the transaction details provided by the customer.

Subscription Management:

Use "Listar clientes por CPF ou CNPJ" to check whether a customer is an existing subscriber and "Atualizar cobrança existente" to modify the terms of an active subscription.

Balance Retrieval:

Before making payments or transfers, use "Recuperar saldo da conta" to ensure sufficient funds.

By following these guidelines and examples, you will be able to use the Asaas integration in NicoChat to manage every financial nuance of your business in an automated and secure way. This integration promises not only to simplify complex procedures, but also to help reduce default rates and strengthen the company's cash flow.

Webhook

Create Webhook in NicoChat

In "Tools", go to "Webhooks".

Create a new Webhook, naming it "Green", and copy the URL provided.

Click “Edit”, enable “Data Preprocessing” and enter the code below:

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.');

}