> For the complete documentation index, see [llms.txt](https://digisac.gitbook.io/manual-digisac-2-0/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://digisac.gitbook.io/manual-digisac-2-0/principais-integracoes/asaas.md).

# Asaas

{% embed url="<https://youtu.be/_rUprbPShAQ>" %}

### O que é o Asaas?

O Asaas é uma plataforma de gestão financeira que permite automatizar cobranças, emitir boletos, gerar cobranças via Pix e acompanhar o recebimento de pagamentos de clientes.

Para saber mais sobre o Asaas, [clique aqui](https://www.asaas.com/).&#x20;

### Por que integrar o Asaas à DigiSac?

A integração permite que o robô da DigiSac consulte automaticamente boletos vinculados ao CPF ou CNPJ informado pelo cliente, enviando a segunda via do boleto, informações de vencimento, valor da cobrança e, quando disponível, o código Pix para pagamento.

### Requisitos para integração:

**No Asaas:**

* Possuir uma conta ativa no Asaas;
* Possuir clientes e cobranças cadastradas na plataforma.
* Gerar um token de acesso (API Token);

  * Para isso, dentro do **Asaas**, clique no **Menu do Usuário**, no canto superior direito, e selecione **Integrações**.

  <figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FhoisiBi2afyCNzACTnHt%2Fimage.png?alt=media&amp;token=6f17666d-2564-4506-9337-772a0c748ecb" alt=""><figcaption></figcaption></figure>

  * Vá até a seção **Chaves de API** e clique em **Gerar chave de API**.

  <figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FXXBU9WVYqXWOOzaI41Zf%2Fimage.png?alt=media&amp;token=d4ff18c9-6acc-47cd-8532-b32e49b5d0f5" alt=""><figcaption></figcaption></figure>

  * No modal, preencha o **Nome da chave**, a **Data de expiração** e o **Horário de expiração**. Em seguida, clique em **Avançar**. Depois, selecione **Enviar código** para receber um código de verificação via SMS no número cadastrado. Após o recebimento, informe o código no campo exibido para e clique em **Gerar chave de API** concluir a validação.

  <figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FPR9onj66lsgbV1WXjfER%2Fimage.png?alt=media&amp;token=0f3cf2e8-a6e5-4d50-bf43-f98ee867c41c" alt=""><figcaption></figcaption></figure>

  * A chave de API será gerada automaticamente. **Copie** e **armazene o código** em um local seguro, pois após fechar essa janela não será mais possível visualizar a chave novamente.

  <figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FW1qK2uTIsRQaYgGjO6j2%2Fimage.png?alt=media&amp;token=1516e440-a2f1-4f91-9c3c-1d9112fe511a" alt="" width="375"><figcaption></figcaption></figure>

**Na Digisac:**

* Integração cadastrada no ambiente;

***

### **Como funciona a integração?**

{% hint style="info" %}
Para utilizar essa integração, é necessário realizar a contratação. Após a contratação, envie o token de acesso, criado no passo a passo acima, ao time de Suporte da Digisac, que será responsável pela ativação da integração. Somente após isso, confira as informações abaixo.
{% endhint %}

Por padrão, o time de Suporte cria um fluxo no **Robô Construtor Legado** para utilização da integração.&#x20;

Após a criação, o fluxo pode ser personalizado pelo próprio cliente em ajustes mais simples, como alteração de mensagens e textos, ou adaptado com o auxílio do **Suporte Técnico** para modificações no fluxo e personalizações que atendam às necessidades da operação.

Quando o robô estiver configurado conforme desejado, basta **vinculá-lo à conexão** que será utilizada na Digisac. Para isso, no **Menu Principal**, acesse **Conexões**. Na conexão desejada, clique nos **três pontinhos** > **Editar**.&#x20;

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FRlly4xgxvToSljsQb3VR%2Fimage.png?alt=media&amp;token=3e56f6aa-e7be-479b-b28d-241812a18e54" alt=""><figcaption></figcaption></figure>

Em seguida, no campo **Robô (Bot da Digisac)**, selecione o robô configurado e clique em **Salvar** para gravar as alterações.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FnQYKP3jUhv69cdPo7ESk%2Fimage.png?alt=media&amp;token=ef2f0d90-02be-435b-96c6-fe0e59881603" alt=""><figcaption></figcaption></figure>

***

#### Fluxo do Robô

Quando um cliente iniciar o atendimento, o robô solicitará ao cliente o **CPF** ou **CNPJ** para realizar a consulta das cobranças no Asaas.

Após o envio do documento:

* Se houver **cobranças vinculadas ao documento** informado, a integração retornará automaticamente com **informações** e a **2ª via do boleto com vencimento mais próximo**.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2Flqv3PczMMushIQbKiOE9%2Fimage.png?alt=media&amp;token=1935accd-f37f-4b74-8ce9-02346b544a12" alt=""><figcaption></figcaption></figure>

* Se o **documento não estiver cadastrado no Asaas**, o robô informará que **não foi possível localizar o cadastro** e **solicitará um novo documento**;

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FBuXVHwzudIKIVzYpT5aL%2Fimage.png?alt=media&amp;token=39385585-7546-4600-9754-b35e0a771578" alt=""><figcaption></figcaption></figure>

* Se o documento for **inválido**, o robô solicitará um novo CPF ou CNPJ;

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2Fb6kEnTyN9P2MTU1q3D1N%2Fimage.png?alt=media&amp;token=929af6f0-0630-47d9-a194-feafe6497e17" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Importante:**

* Caso existam várias cobranças vinculadas ao mesmo documento, a integração retornará apenas o boleto com vencimento mais próximo.
* A consulta é realizada exclusivamente por CPF ou CNPJ.
* O envio do código Pix depende da cobrança possuir essa forma de pagamento disponível no Asaas.
  {% endhint %}