# Programa de indicação Um **programa de indicações** é um sistema que recompensa clientes ou parceiros da empresa oferecendo incentivos ou bônus por trazer novos participantes. Do ponto de vista técnico, um programa de indicações inclui vários componentes principais: 1. Um **link de convite**— um identificador único que permite que usuários ou clientes convidem outras pessoas para participar do programa. Quem convida pode compartilhar esse link por vários canais (por exemplo, este artigo abordará a geração de links por meio de um bot do WhatsApp, mas os links do programa de indicações podem ser compartilhados por qualquer mensageiro de sua preferência). 2. Um **banco de dados de participantes**, implementado por meio da integração das funcionalidades do MaviBot e do Google Sheets, onde são registradas informações tanto do usuário convidado quanto de quem convidou. 3. Um **sistema de rastreamento de indicações** que monitora ações relacionadas à entrada de novos participantes por meio de links de indicação. O sistema armazena dados de todas as indicações, permitindo verificar se uma determinada indicação já existe no sistema como um usuário previamente convidado. {% hint style="success" %} Recomendamos fortemente revisar as seções “Básicos da criação de bots no Mavibot.ai” **ссылка** e “Google Sheets” **ссылка** antes de criar o fluxo do seu chatbot. {% endhint %} ## Sistema de Indicações no WhatsApp A funcionalidade do bot que está sendo criado incluirá blocos compostos pelos seguintes componentes: 1. geração de um link de indicação (afiliado); **ссылка** 2. verificação se o novo usuário já está no banco de dados; **ссылка** 3. notificação ao usuário que convidou sobre uma nova indicação; **ссылка** 4. registro de usuários no banco de dados; **ссылка** 5. solicitação de uma lista de indicações. **ссылка** ### Geração de link de indicação Vamos criar um bloco com um link incorporado que o bot enviará ao usuário ao receber o comando “link”. Para isso, crie um novo bloco no fluxo usando um dos dois métodos: 1. Clique duas vezes em uma área vazia na tela do construtor:

Como criar um bloco com um clique do mouse

2. Usando o **botão "Salvar"** na parte inferior da tela e selecionando o tipo de bloco:

Como criar um bloco com um tipo selecionado

Depois disso, na condição do bloco, digite a palavra **“Link”** e defina o tipo de correspondência como **“Ignorar erros de digitação e imprecisões”** (isso é útil em caso de erros de digitação do usuário ou outros erros na mensagem):

Para identificar quem indicou o usuário, o bot cria um link usando o seguinte modelo: [https://wa.me/(seu](https://wa.me/%28your) número de telefone vinculado ao bot)text=Você%20foi%20recomendado%20por%20#{phone}%20😌Olá

Fig. 2 Como inserir um link em um bloco do fluxo

Vamos analisar mais de perto o link modelo: [https://wa.me/(seu](https://wa.me/%28your) número de telefone vinculado ao bot)?text=Você%20foi%20recomendado%20por%20#{phone}%20😌Olá, onde: 1. Substitua os parênteses "(seu número de telefone vinculado ao bot)" pelo número de telefone correspondente; 2. \#{phone} é substituído automaticamente pelo número de telefone do usuário que solicitou o link de parceiro. Enviamos o link gerado não como texto do bloco, mas como um anexo — um link clicável com uma notificação (veja as Fig. 2 e Fig. 3): * escolha inserir um anexo * selecione o tipo — Link, e cole no campo 'URL do anexo':

Nesse caso, o link aparecerá visualmente encurtado: ![Fig. 4. Visualização no WhatsApp](https://lh5.googleusercontent.com/vW_tS8GIDqDbN0PkdgQsa6xeeiBBfxuC4Qp8QuzXRz98yI4fphKEUIE22MiBcq4q_RvlQLlAEtlVzcL-hln5DbHaM-F1tuSBNp9y5zhvR5efRmjzDbcTlox5AUDvhnVorlBEdYsX) Vamos testar a funcionalidade do link usando o recurso **"Bot de Teste"** .

Aqui está o resultado: o link direciona o usuário para a conversa correspondente no mensageiro com o seu número de telefone:

Dessa forma, você gerou com sucesso um link de convite que os potenciais usuários podem usar para acessar o chatbot. Além disso, ao clicar nesse link, o usuário é redirecionado para a janela de chat com uma mensagem pré-preenchida. (Veja a Fig. 6) ![Fig. 6. Mensagem preenchida no WhatsApp](https://lh5.googleusercontent.com/60e0Pcv5362t53lD5Y0evDiAAmeyCoL-eSg_1wXPsgFiKw-Nn0Zmb3WUwBE16lCBr84e56RB863VJd8GFW4kqZAsXMRzEEIFum_ThIdbr58IqV9_JP-kp3IVnfNZoAsJ7d_n4OI4) ### Verificação do usuário **Usando funções e expressões regulares em um bloco** O comando de verificação e entrada no banco de dados só funcionará se o bot encontrar um número de telefone na mensagem do usuário. Portanto, é necessário dividir a frase recebida em partes. Para isso, a função **splitter()** é usada. {% tabs %} {% tab title="Função splitter()" %} **splitter(str, s, n)** - divide uma string em partes. A função retorna um array de elementos.
Parâmetros: **!** **str** - a string original **!** **s** - o delimitador da string **n** - o número máximo de elementos {% endtab %} {% tab title="Exemplo" %} Função de divisão de string:

{% endtab %} {% endtabs %} Em seguida, o bot precisa verificar se a sequência de dígitos na string é realmente um número de telefone. Para isso, usamos as seguintes expressões regulares: * Número de telefone genérico: `^(\+)?((\d{2,3}) ?\d|\d)(([ -]?\d)|( ?(\d{2,3}) ?)){5,12}\d$` * **Trocar o número russo!** Somente número de telefone russo: `^((\+7|7|8)+([0-9]){10})$`

Fig. 9. Expressão regular para número de telefone

{% hint style="info" %} Para saber mais sobre o trabalho com expressões regulares, consulte o artigo intitulado "Expressões Regulares". **ссылка** {% endhint %} Depois que o bot verificar que a sequência de dígitos é realmente um número de telefone, salve-a da mensagem como uma variável (por exemplo, #{reff}). **Verificação do número de telefone do usuário como indicação no banco de dados** Agora é necessário verificar se o número de telefone do usuário que seguiu o link já é uma indicação (anteriormente convidado por alguém e registrado em nosso banco de dados). Para isso, crie um bloco no fluxo com uma função de busca de coluna. Use a função de busca de coluna clicando em **"Solicitação de API"** no bloco, onde você precisa definir os seguintes valores de parâmetro:

**!**** URL da função**: **ссылка** **!**** JSON** **parâmetros da solicitação:** **{ "id": "your\_table\_id", "find": "text\_to\_search", "col": column\_number\_to\_search\_in, "return": column\_number\_to\_return, "creds\_path": "path\_to\_your\_auth\_credentials\_file" }** Parâmetros da resposta: "status": "1" — valor encontrado "status": "0" — valor não encontrado "data" — o valor encontrado "cell\_number" — a localização da célula encontrada {% tabs %} {% tab title="Busca por coluna e exibição de texto da linha inteira" %} O parâmetro return deve ser definido como 0.\ \&#xNAN;**{ "id": "your\_table\_id", "find": "text\_to\_search", "col": 2, "return": 0 }**\ Resposta: {"status":"1","data":{"0":"\u0441\u043e\u043b\u043d\u0446\u0435","1":"\u0440\u0430\u0441\u0441\u0432\u0435\u0442","2":"\u043a\u0440\u044b\u0448\u0430","3":"","4":"\u043d\u0435\u0431\u043e"},"cell\_number":{"row":4,"col":1, "col\_letter":"A"}}\ Detalhamento da resposta: data — resposta data|0 — Célula 1 data|1 — Célula 2 data|2 — Célula 3 data|3 — Célula 4 cell\_number|row — linha cell\_number|col — coluna {% endtab %} {% endtabs %} {% hint style="info" %} Para saber mais sobre as funções disponíveis para trabalhar com tabelas, consulte o artigo intitulado "Google Sheets". **ссылка** {% endhint %} ### Bloco de notificação Para notificar o usuário que compartilhou o link de indicação de que um novo cliente o seguiu com sucesso, criaremos um bloco dedicado. Para enviar uma notificação sobre a criação de uma nova indicação, use os seguintes parâmetros da solicitação (tipo: **POST - JSON**):

As solicitações são feitas usando o **POST** método para a URL: **`https://chatter.salebot.pro/api/{api_key}/{action}`** Onde: * **`api_key`** é a chave de acesso à API do seu projeto, que pode ser obtida nas configurações do projeto (veja a Fig. 11).

Você pode recuperar a chave de acesso usando a variável **#{api\_key}**, que armazena o token de acesso gerado atualmente. **Não se esqueça de gerar o token antes de usá-lo.** **!**** URL da solicitação:** [**https://chatter.salebot.pro/api/#{api\_key}/whatsapp\_message**](https://chatter.salebot.pro/api/#{api_key}/whatsapp_message) **ссылка**

{% hint style="info" %} Você pode encontrar mais detalhes sobre as funções de solicitação da API aqui. **ссылка** {% endhint %} ### Adicionando os usuários convidados e quem convidou ao banco de dados Para isso, usaremos a inserção linha por linha em colunas específicas, o que é feito usando o **mapeamento** função. {% hint style="danger" %} A tabela deve ter um cabeçalho preenchido (pelo menos uma célula na primeira linha). {% endhint %} **!**** URL da função** **ссылка** **!**** JSON** **parâmetros da solicitação:** { "id": "your\_table\_id", "mapping": { "a": "#{variable}", "b": "#{another\_variable}", "d": "plain text" } } Se você quiser gravar linhas não na primeira planilha, adicione o parâmetro **list\_name** à solicitação: { "id": "your\_table\_id", "mapping": { "a": "plain text", "b": "#{variable}" }, "list\_name": "SheetName" } Parâmetros: * **id** — identificador da tabela\* * **a, b, c, d** — nomes das colunas * **list\_name** — nome da sua planilha (por exemplo, "Sheet2") \*Certifique-se de substituir pelo ID real da sua tabela. > Exemplo de resposta: **{"number\_row":8}** Se a solicitação for executada com sucesso, a resposta incluirá o número da linha, que você pode salvar e usar para operações futuras. ### Visualizando a lista de indicações Vamos adicionar um comando extra ao bot que permite aos usuários visualizar sua lista de indicações. Para encontrar todos os valores especificados em uma coluna, use a **findcell** função com o parâmetro **"find\_all"**. Isso localizará todas as ocorrências do **"find\_all"** valor na **"col"** coluna especificada e retornará uma lista de valores únicos da **"return"** coluna como uma string. **!**** URL da função:** **ссылка** **!**** Parâmetros da solicitação JSON:** { "id": "table\_id", "find\_all": "search\_value", "list\_name": "sheet\_name", "col": "column\_number\_to\_search\_in", "return": "column\_number\_to\_return\_values\_from", "find": "!" }

Nos valores salvos, especifique: list → Lista quantity → Quantidade Para o usuário, exiba a mensagem: *"Você indicou #{spisok}, seu total de indicações: #{quantity}"* Em outros mensageiros, implementar esse sistema de indicações é ainda mais fácil porque os dados de quem convidou são passados como um parâmetro oculto durante a transição pelo link, então o novo usuário não precisa enviar uma mensagem como *“Fui convidado por este número.”* --- # Agent Instructions: 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: ``` GET https://docs.mavibot.ai/doc/pt/como-fazer.../programa-de-indicacao.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.