> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/cobranca.md).

# Cobrança

Funcionalidade em beta

{% hint style="warning" %}
**Disponível para o perfil:** Administrador e Supervisor
{% endhint %}

A funcionalidade de **Cobranças** permite gerar, dentro da própria conversa de WhatsApp, uma ficha de pagamento com **Pix, boleto ou link**, informando os itens e o valor cobrado do cliente. O sistema centraliza todas as cobranças enviadas em uma única tela, mostrando quanto ainda falta receber e quanto já foi pago.

{% hint style="danger" %}
**O WhatsApp não avisa quando o cliente paga.** A confirmação do pagamento é **manual**: você precisa conferir o recebimento na sua conta (bancária, do link de pagamento, etc.) e marcar a cobrança como paga dentro do Z-PRO.
{% endhint %}

***

#### Como funciona

A cobrança nasce dentro do atendimento, quando o agente envia um **template de cobrança (API Oficial)** para o contato. O cliente recebe uma ficha com os itens, o valor total e a forma de pagamento escolhida (Pix, boleto ou link).

Depois que o pagamento é confirmado manualmente por quem está gerenciando as cobranças:

* O cliente recebe uma **mensagem de confirmação** automática.
* A ficha de cobrança no WhatsApp do cliente passa a exibir o **selo de "pago"**.

{% hint style="info" %}
Além do envio manual no atendimento, a cobrança também está disponível em **Nova Conversa (avulsa), Disparo em Massa, Campanhas, Agendamentos, Funil de Vendas e Chatbot (ChatFlow)** — todos reaproveitando o mesmo template de cobrança criado em Integrações Meta.
{% endhint %}

***

#### Pré-requisito: criar um template de cobrança

Antes de enviar qualquer cobrança, é preciso criar um template WABA com um botão do tipo **Cobrança**.

1. Acesse **Configurações → Integrações Meta → Templates → Templates WABA → Criar Template**.
2. Preencha as **Informações Básicas**: Conexão WABA, App ID, Nome do Template, Idioma e Categoria — os mesmos campos usados para qualquer template WABA.
3. Em **Componentes**, adicione um componente do tipo **Botões**.
4. Ao adicionar o botão, escolha o tipo **Cobrança (Pix, boleto ou link)** — opção que aparece junto de Resposta Rápida, URL, Telefone e OTP.
5. Preencha o **Texto do botão** e clique em **Criar Template**.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FMZZVEWmDSKuz8FKSnA0G%2Fimage.png?alt=media&amp;token=ff97fa97-99b8-4e4d-8abf-fb27316bbeaf" alt=""><figcaption></figcaption></figure>

***

#### Enviando uma cobrança no atendimento

1. Dentro do ticket, clique em **Enviar template**.
2. Selecione o template de cobrança criado.
3. Preencha os **Dados para pagamento** — esses valores aparecem na ficha que o cliente recebe:

| Campo                          | Descrição                                                                                                                                               |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Itens**                      | Descrição, quantidade e valor de cada item. Clique em **+ Adicionar item** para incluir mais de um.                                                     |
| **Tipo de produto**            | Ex: "Produto digital ou serviço ou Produto físico                                                                                                       |
| **Desconto / Frete / Imposto** | Valores somados/subtraídos do subtotal para compor o **Total**, calculado automaticamente.                                                              |
| **Forma de pagamento**         | **Pix**, **Link de pagamento** ou **Boleto**.                                                                                                           |
| **Código Pix copia e cola**    | Ao colar o código, os campos **Nome do recebedor** e **Chave Pix** são preenchidos automaticamente (também podem ser digitados/corrigidos manualmente). |
| **Vencimento (opcional)**      | Data/hora limite + texto de aviso de prazo para o cliente. Sem vencimento definido, a cobrança fica em aberto até alguém dar baixa manualmente.         |

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FQOvsdFWAAXfRuhPMr6Rz%2Fimage.png?alt=media&amp;token=71b8f6a1-8ab6-4613-9b9f-82e7e7b95bb6" alt="" width="292"><figcaption></figcaption></figure>

4. Clique em **Enviar Template**.

***

#### O que o cliente recebe

O contato recebe, no WhatsApp, um card de **Cobrança** com:

* Número da cobrança
* Item(ns) e quantidade
* Forma de pagamento escolhida
* Subtotal, desconto, frete e Total (em destaque)
* No caso de Pix: botão **Copiar código Pix**

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2F3yBu9zNQxBRpEgVwWJOC%2Fimage.png?alt=media&amp;token=ee7fd4ba-12a4-4c0d-adc1-6064a7c829ea" alt="" width="176"><figcaption></figcaption></figure>

***

#### Acompanhando as cobranças

Acesse **Gestão Comercial → Cobranças** para ver todas as cobranças enviadas em um só lugar.

**Nesta tela:**

* **Total a receber** soma as cobranças que ainda aguardam pagamento; **Total recebido** soma as já pagas.
* Use o filtro **Situação** para separar o que está em aberto do que já foi pago, cancelado ou expirado **\[CONFIRMAR lista completa de situações — vista até agora: "Cobrança não enviada" e as citadas no texto de ajuda: em aberto, paga, cancelada, expirada]**.
* A busca por **Nº da cobrança** usa o número exato, o mesmo que aparece na ficha do cliente.
* A tabela mostra: Nº da cobrança, Contato, Canal, Total, Forma de pagamento, Situação, Data e Ações.
* Em **Ações**, é possível marcar a cobrança como paga

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FLBPjUmqedQKaospd90UW%2Fimage.png?alt=media&amp;token=bc1a9d91-7d8a-4ffa-ac2d-78f600783e8c" alt=""><figcaption></figcaption></figure>

***

#### Avisos e precauções

{% hint style="danger" %}
**Confirmação manual:** o WhatsApp não notifica o Z-PRO quando o cliente paga. Sempre confira o recebimento na sua conta antes de marcar a cobrança como paga — marcar incorretamente pode gerar confirmação indevida ao cliente.
{% endhint %}

{% hint style="warning" %}
**Sem vencimento definido**, a cobrança permanece em aberto indefinidamente até que alguém dê baixa manual.
{% endhint %}

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/cobranca.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
