> For the complete documentation index, see [llms.txt](https://wedocs.gitbook.io/wedocs-5.1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wedocs.gitbook.io/wedocs-5.1/cliente-desktop/cadastro-de-tarefas-e-alertas/enviar-whatsapp.md).

# Enviar WhatsApp

O Weknow permite configurar tarefas para enviar mensagens automaticamente pelo WhatsApp. Para utilizar o recurso, é necessário configurar um provedor de envio, que pode ser **Wzap** ou **Twilio**.

O processo envolve duas etapas principais:

1. Cadastrar e configurar o provedor no Weknow.
2. Criar uma tarefa para definir quando, o que e para quem as mensagens serão enviadas.

### Configurando o provedor

Antes de criar uma tarefa de envio, é necessário possuir uma configuração válida em um dos provedores disponíveis.

Atualmente, o Weknow permite utilizar:

* **Wzap**;
* **Twilio**.

As informações necessárias para o cadastro da configuração no Weknow devem ser obtidas junto ao respectivo provedor.

1 -  WzapChat:

{% embed url="<https://www.wzap.chat/>" %}

2 -  Twilio:

{% embed url="<https://www.twilio.com/pt-br>" %}

#### Wzap

Para utilizar o Wzap, é necessário possuir as informações de acesso fornecidas pelo serviço, como o **Token** e, quando aplicável, o **Dispositivo**.

No Weknow Desktop, acesse:

**Configurações > WhatsApp > Wzap**

<figure><img src="/files/aMJgBOytNQRpl4Vs9rLZ" alt=""><figcaption></figcaption></figure>

Cadastre uma nova configuração de envio e informe:

* **Descrição:** identificação da configuração;
* **Token:** token obtido no portal do Wzap;
* **Dispositivo:** dispositivo utilizado para o envio, quando aplicável.

Após preencher os dados, clique em **Testar** para validar a configuração e, em seguida, em **Salvar**.

#### Twilio

Para utilizar o Twilio, é necessário possuir uma conta no serviço e obter as credenciais necessárias para a integração.

No Weknow Desktop, acesse:

**Configurações > WhatsApp > Twilio**

<figure><img src="/files/LBCQOX4PXsfCr4cPEX7m" alt=""><figcaption></figcaption></figure>

Cadastre uma nova configuração de envio e informe:

* **Descrição:** identificação da configuração;
* **Account SID:** identificador da conta no Twilio;
* **Auth Token:** token de autenticação;
* **Remetente:** número utilizado para o envio das mensagens;
* **Serviço de armazenamento na nuvem:** serviço utilizado para armazenar arquivos relacionados ao envio.

No campo **Serviço de armazenamento na nuvem**, estão disponíveis as opções:

* **Nenhum:** não utilizar um serviço de armazenamento em nuvem;
* **Amazon S3:** utilizar o Amazon S3 para armazenamento dos arquivos.

Ao selecionar **Amazon S3**, serão apresentados campos adicionais para configurar o armazenamento:

* **Amazon S3:** selecione a configuração do serviço Amazon S3 cadastrada no Weknow;
* **Amazon S3 Bucket:** informe o bucket que será utilizado.

{% hint style="warning" %}
**Importante:** o cadastro e a configuração do Amazon S3 são necessários somente quando a opção **Amazon S3** for selecionada.
{% endhint %}

Após preencher os dados, clique em **Testar** para validar a configuração e, em seguida, em **Salvar**.

### Definindo o provedor padrão

Depois de cadastrar uma ou mais configurações de envio, é possível definir qual delas será utilizada como **provedor padrão para o envio de mensagens pelo WhatsApp**.

No Weknow Desktop, acesse:

**Configurações > Gerais > Envio de mensagens (E-mail, SMS, Telegram e WhatsApp)**

<figure><img src="/files/K85XTX8ybME9cVtSCY0J" alt=""><figcaption></figcaption></figure>

**Quantidade máxima de tentativas de envio:** Define quantas tentativas o Weknow realizará para enviar uma mensagem antes de cancelar o envio.

* **Valor preenchido:** define o número máximo de tentativas.
* **Campo vazio:** utiliza **3 tentativas**, que é o valor padrão.
* **0 (zero):** permite tentativas ilimitadas. Essa opção **não é recomendada**.

**Provedor padrão para envio de mensagens para o WhatsApp:** Permite definir qual configuração de **Wzap ou Twilio** será utilizada como provedor padrão para o envio de mensagens pelo WhatsApp.

***

## Criando uma tarefa de envio

Depois de configurar o provedor, é possível criar a tarefa responsável pelo envio automático das mensagens.

Acesse:

**Ferramentas > Gerenciar tarefas > Cadastro de tarefas**

<figure><img src="/files/NdIFRlrqbHsDL57SuAAd" alt=""><figcaption></figcaption></figure>

Cadastre a tarefa e configure seus dados gerais, gatilhos e frequência de execução conforme a necessidade.

Na aba **Ações**, clique em **Adicionar** e selecione:

**Enviar WhatsApp:** A configuração do envio é dividida em etapas:

### Configurando a mensagem

Acesse:

**Ações > Adicionar > Enviar WhatsApp > Mensagens > Adicionar**

<figure><img src="/files/iKHQyEOX0GFTPgOW1cMQ" alt=""><figcaption></figcaption></figure>

Informe:

* **Descrição:** identificação da mensagem;
* **Conteúdo:** tipo de conteúdo que será enviado.

<figure><img src="/files/afNHzSoTfHd02hzfPgC5" alt=""><figcaption></figcaption></figure>

O conteúdo pode ser configurado de acordo com as opções disponibilizadas pelo Weknow, como **Componente, Dashboard ou Texto**.

### Configurando os destinatários

Acesse:

**Ações > Adicionar > Enviar WhatsApp > Destinatários > Adicionar**

<figure><img src="/files/PjE7XMyF45Bkux7MBh1m" alt=""><figcaption></figcaption></figure>

Os destinatários podem ser definidos por diferentes formas, permitindo combinar destinatários cadastrados no Weknow com números obtidos por consulta SQL.

**Números:** Permite informar diretamente os números de telefone dos destinatários que não estejam cadastrados nos contatos do Weknow.&#x20;

**Contatos:** Permite selecionar contatos previamente cadastrados no Weknow.

**Grupos de contatos:** Permite selecionar grupos de contatos cadastrados no sistema.

As opções de **Números, Contatos e Grupos de contatos** podem ser utilizadas em conjunto no mesmo cadastro.

#### Destinatários obtidos por SQL

Também é possível obter os números dos destinatários por meio de uma consulta SQL.

Para isso, informe:

* **Conexão:** conexão utilizada para executar a consulta;
* **Código SQL:** código responsável por retornar os destinatários;
* **Campo Número:** campo do resultado da consulta que contém o número de telefone do destinatário.

{% hint style="info" %}
**Observação:** as diferentes formas de seleção de destinatários podem ser utilizadas de acordo com a necessidade da tarefa.
{% endhint %}

***

## Configurando o provedor da tarefa

Na configuração da ação **Enviar WhatsApp**, também é possível definir o provedor que será utilizado no envio, conforme as opções disponíveis na versão do Weknow.

<figure><img src="/files/wLIwfVnC4UrT8AusUDh1" alt=""><figcaption></figcaption></figure>

Quando aplicável, utilize a configuração previamente cadastrada para o Wzap ou Twilio.

{% hint style="warning" %}
Ao configurar uma tarefa via Twilio, é possível definir o template desejado. Para mais detalhes sobre a configuração de templates, consulte: [Twilio - Envio de Mensagens com Templates no WhatsApp](https://www.twilio.com/docs/whatsapp/tutorial/send-whatsapp-notification-messages-templates).
{% endhint %}

***

## Finalizando a configuração

Depois de configurar a mensagem, os destinatários e o provedor, clique em **OK** para concluir a configuração da ação.

A ação **Enviar WhatsApp** será apresentada na aba **Ações** da tarefa.

<figure><img src="/files/qLBKvWbeBWMIZUCbHSRi" alt=""><figcaption></figcaption></figure>

Para editar uma configuração existente, abra a ação cadastrada e altere os dados necessários.

Por fim, salve a tarefa e certifique-se de que ela esteja **ativada** para que possa ser executada conforme os gatilhos e horários definidos.

{% hint style="danger" %}
O Gerenciador de Tarefas deve estar em execução com as opções **Executador de tarefas/alertas cadastrados** e **Envio da fila de mensagens do WhatsApp**  habilitadas para que as tarefas configuradas sejam processadas.

<p align="center"><img src="/files/M9CD0yZe8eOBa9ZdvYlQ" alt="" data-size="original"></p>
{% endhint %}

{% hint style="info" %}
Saiba mais sobre Wzap: <https://www.wzap.chat/>

Saiba mais sobre Twilio: [https://www.twilio.com/pt-b](https://www.twilio.com/pt-br)r
{% endhint %}