> For the complete documentation index, see [llms.txt](https://docs.fortics.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/novos-tutoriais-organizar/fluxo-basico-de-integracao-com-o-whatsapp-payments.md).

# Fluxo Básico de Integração com o WhatsApp Payments

O WhatsApp Payments permite que as informações de pagamento sejam enviadas automaticamente aos clientes durante a jornada de atendimento. Para isso, é necessário integrar o Chat Center ao gateway ou sistema de pagamento utilizado pela empresa.&#x20;

Este tutorial apresenta um **fluxo básico de exemplo**, criado com o objetivo de demonstrar como essa integração pode ser realizada utilizando os componentes disponíveis nos Fluxos de Atendimento.&#x20;

Ao longo do fluxo, será realizada uma requisição para um serviço externo, os dados retornados serão tratados e, ao final, utilizados no envio de um Modelo de Mensagem do WhatsApp Payments.&#x20;

{% hint style="info" %}
**## Informação**\
\
Este fluxo possui finalidade exclusivamente demonstrativa e utiliza uma API de exemplo que retorna informações fixas apenas para facilitar o entendimento da integração.&#x20;

Cada empresa possui seu próprio gateway de pagamento, regras de negócio e estrutura de integração. Utilize este exemplo como referência para compreender a lógica da integração e adaptá-la conforme as necessidades da sua empresa.&#x20;
{% endhint %}

### Pré-requisitos&#x20;

**Permissão necessária:** Adicionar, Editar e Remover [Fluxos de Atendimento](/perguntas-frequentes/perguntas-frequentes-1/novos-tutoriais-organizar/equipes-de-atendimento.md).&#x20;

O usuário responsável por executar este tutorial precisa ter ativa a permissão de gerenciamento de Fluxos de Atendimento. Caso essa opção não esteja disponível no seu perfil, solicite a liberação ao administrador da plataforma antes de prosseguir.&#x20;

**Canal de WhatsApp válido**: Antes de utilizar o WhatsApp Payments, é necessário que exista um canal do WhatsApp configurado no Chat Center, [vinculado a uma conta oficial do WhatsApp Business (WABA) ](/perguntas-frequentes/perguntas-frequentes-1/channel-connect/cadastrando-uma-conta-de-whatsapp-no-channel-connect.md)e conectado ao Channel Connect.&#x20;

**Modelo de Mensagem aprovado**: O modelo de mensagem do [WhatsApp Payments](broken://pages/gWrRGseCQo88QN0w7OTb) que será utilizado no fluxo deve estar previamente criado e aprovado pela Meta. &#x20;

**Integração com o gateway de pagamento**: O gateway de pagamento utilizado pela empresa deve disponibilizar uma API capaz de fornecer as informações da cobrança que serão utilizadas durante o fluxo, como código PIX, valor da cobrança, identificadores de pedidos e demais dados necessários para o envio do Modelo de Mensagem.&#x20;

### Obtendo as informações da cobrança&#x20;

O primeiro componente utilizado é o[ **RPA - Requisição**](/perguntas-frequentes/perguntas-frequentes-1/chat-center/componentes-do-fluxo/componente-fluxo-rpa.md).&#x20;

<img src="/files/nNb50a9FTNkyrZy4qxka" alt="" height="361" width="460">

Esse componente utiliza uma [**requisição REST**](/perguntas-frequentes/perguntas-frequentes-1/chat-center/automacao-com-api-rest-conectando-sistemas.md) para consumir uma URL da integração com o gateway de pagamento.&#x20;

Neste exemplo, a API retorna apenas duas informações para fins de demonstração:&#x20;

* Código PIX; &#x20;
* Valor da cobrança. &#x20;

No campo **Tipo de Resposta**, configure o componente para armazenar a resposta da requisição em uma variável. Neste exemplo, foi utilizada a variável **{{RESPONSE}}.**&#x20;

### Tratando os dados retornados&#x20;

Após a execução da requisição, a variável {{RESPONSE}} armazenará todas as informações retornadas pela API.&#x20;

Como o Modelo de Mensagem utilizará apenas parte desses dados, será necessário separá-los antes de prosseguir.&#x20;

Para isso, foram adicionados dois componentes **Script**:&#x20;

O primeiro é responsável por extrair apenas o código PIX retornado pela API e armazenar o retornona variável **PIX\_COPIE\_COLA**.\
.&#x20;

<img src="/files/9PKeaqdeT8oajds7KC0U" alt="" height="511" width="359">

&#x20;\
O segundo extrai apenas o valor da cobrança e armazena o retorno da função na variável **VALOR\_PIX**.\
&#x20;

Dessa forma, cada informação fica armazenada em uma variável específica, facilitando sua utilização nas próximas etapas do fluxo.&#x20;

### Enviando o Modelo de Mensagem&#x20;

Após obter as informações da cobrança, adicione ao fluxo o componente **Modelo de Mensagem**. Dentro do componente, selecione o Modelo de Mensagem PIX previamente criado e aprovado.

<img src="/files/PbexwFUAYaBbUpPa1nNv" alt="" height="459" width="405">

Em seguida, clique em editar variáveis para associar aos campos do modelo as variáveis obtidas nas etapas anteriores, como o código **PIX e o valor da cobrança**.

<img src="/files/JV0r5p7XbRnYYuow8ATS" alt="" height="199" width="601">

\
\
O exemplo acima mostra a associação correta das variáveis. No JSON de criação do modelo estamos utilizando {{1}} e {{2}} como placeholders para as variáveis **PIX\_COPIE\_COLA e VALOR\_PIX**&#x20;

Quando o fluxo chegar a esse componente, o cliente receberá automaticamente o Modelo de Mensagem contendo as informações retornadas pelo gateway de pagamento.&#x20;

### Resultado da integração&#x20;

&#x20;\
Após a execução do fluxo, o Chat Center realizará a requisição ao gateway de pagamento, obterá as informações da cobrança, preencherá automaticamente as variáveis configuradas e enviará o Modelo de Mensagem PIX ao cliente.&#x20;

<img src="/files/fmCHkNSamHx7KKST1d22" alt="" height="481" width="408">

No exemplo deste tutorial, o cliente recebe uma mensagem contendo o valor da cobrança e um botão para copiar o código PIX, permitindo realizar o pagamento diretamente a partir das informações enviadas pelo WhatsApp.


---

# 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://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/novos-tutoriais-organizar/fluxo-basico-de-integracao-com-o-whatsapp-payments.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.
