> 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/wedocs-4.5/client-desktop/cadastros-gerais/provedores-de-comunicacao.md).

# Provedores de Comunicação

## **E-mail remetente**

Através do Weknow, é possível enviar alertas por e-mails de forma automática em monitoramento, ou de forma manual, e para isto será necessário configurar um servidor e conta de e-mail para o envio.

A seguir, veremos os passos para configurar no weKnow os servidores e contas de e-mail que servirão como possíveis remetentes nos envios pela ferramenta:

Abra o Weknow Client em qualquer máquina, e acesse o menu *<mark style="color:blue;">Configurações</mark>* <mark style="color:blue;"></mark><mark style="color:blue;">>></mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">Servidores SMTP</mark>:*

<div align="left"><img src="/files/1MXCWsfCsep2DmcspR9M" alt=""></div>

Para iniciar seu Cadastro, clique no botão “***\****”

Informe os dados do servidor de e-mail e da conta de e-mail que será usada para enviar mensagens

Em *<mark style="color:blue;">Segurança</mark>*, verifique com sua equipe de infraestrutura qual o modo de segurança padrão para seu servidor de e-mails

<div align="left"><img src="/files/0FPEsiUJAFuPWS695Gzt" alt=""></div>

<div align="left"><img src="/files/lkKhrEzvMuinosYS3iuv" alt=""></div>

Ao selecionar a opção “*<mark style="color:blue;">Este é o servidor padrão para envio de e-mails</mark>*” o endereço eletrônico informado será a referência quando selecionada a opção “<mark style="color:blue;">**PADRÃO**</mark>” para o envio de e-mails.

Para testar se as configurações registradas estão corretas, clique no botão >><mark style="color:blue;">**TESTAR**</mark>

Clique em *<mark style="color:blue;">Salvar</mark>* para concluir o cadastro.

## **Configuração de Provedores SMS**

Através do Weknow, é possível realizar o envio automático mensagens de texto, e então alertar os profissionais que determinadas situações estão ocorrendo e precisam de atenção ou tomada de ações.

Para que o envio seja possível será necessário primeiramente cadastrar suas configurações básicas através do menu *<mark style="color:blue;">CONFIGURAÇÕES</mark>*, através da função *<mark style="color:blue;">PROVEDORES SMS</mark>*, e posteriormente testados em *<mark style="color:blue;">CONFIGURAÇÃO PROVEDORES SMS</mark>*, onde se escolherá o provedor padrão de envios.

A seguir estão descritos os passos para <mark style="color:blue;">configurar um servidor de</mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">SMS</mark>* no Weknow:

Abra o Weknow, e acesse o menu *<mark style="color:blue;">**Configurações >> PROVEDORES SMS**</mark>*

<div align="left"><img src="/files/xIZ6wKL8IIgsB6mWdIjN" alt=""></div>

Para utilizar o envio de SMS, o cliente deverá ter uma conta com uma prestadora deste serviço de envios SMS. Ao obter um plano com prestadoras deste serviço, o cliente recebe, dentre a documentação do fornecedor, informações sobre API de conexão ao serviço, e nome de usuário e uma senha. Tenha estas informações em mãos para continuidade da parametrização e testes.

Na tela de *<mark style="color:blue;">Configuração de SMS</mark>*, para iniciar seu Cadastro, clique no botão “***\****”;

Descreva o serviço provedor SMS, identificando a operadora contratada no campo *<mark style="color:blue;">Nome</mark>* e informe seu *<mark style="color:blue;">link URL BASE</mark>* para comunicação da <mark style="color:blue;">API</mark> que fará conexão com o serviço:<br>

<div align="left"><img src="/files/C44I4qtxumk0xryYNxON" alt=""></div>

<mark style="color:blue;">**Importante:**</mark>\ <mark style="color:blue;">Certifique-se com sua equipe de Infraestrutura, que o link URL BASE esteja completamente livre de bloqueios em sua rede e políticas de segurança!</mark>

No botão “*<mark style="color:blue;">**+**</mark>*”, insira os parâmetros necessários e seus títulos/descrições, conforme necessidade relatada na documentação do seu fornecedor de serviços SMS:

<div align="left"><img src="/files/2pn4iW3hK8UixJHi6kFN" alt=""></div>

**Importante:**\
Neste cadastro de parametrização não serão informados os valores diretos de usuário e senha relacionados a respectiva conta. Quando citado usuário e senha nesta área, apenas se está parametrizando como a API vai trafegar mensagens para o Weknow.

A informação ou atualização de usuário e senha do serviço SMS serão descritos no próximo tópico, dentro da função em ***menu Configurações>> CONFIGURAÇÃO PROVEDORES SMS, campos usuário e senha.***

Em *Fórmula Sucesso* e *Fórmula Erro*, deverá ser informado as regras para identificar quando a mensagem foi enviada com sucesso ou erro, também de acordo com a documentação do provedor.

Na sequência temos alguns exemplos de parametrizações testadas com equipe Weknow e clientes quanto a alguns provedores SMS no mercado:

#### **Provedor:** *SMS Fácil* *URL:* [*http://smsfacil.com.br/api/enviasms/*](http://smsfacil.com.br/api/enviasms/) *Parâmetros:*

*Fórmula sucesso:*\
&#x20;   *SUBSTR(:result;1;2)="OK"*\
*Fórmula erro:*\
&#x20;   *CASEEX(SUBSTR(:result;2;1);"2";"Formato de número móvel de destintário inválido.";"3";"Indica que o texto da mensagem está vazio.";"4";"Número móvel inválido ou não suportado pelo sistema.";"5";"Sistema indisponível tente novamente mais tarde. (muito raro)";"7";"Crédito insuficiente para realizar o envio.";"8";"Usuário ou senha inválidos.";"9";"Data ou hora de agendamento inválidos.Os parâmetros data e hora (se informados), devem possuir valores válidos.")*<br>

<div align="left"><img src="/files/7Ki5p5aeLlA5rNzpfvh8" alt=""></div>

Uma vez feitas as parametrizações relacionadas conforme documentação dos fornecedores de serviço SMS, para continuidade de testes dos provedores selecionados, acesse *<mark style="color:blue;">menu</mark>* *<mark style="color:blue;">Configurações >> CONFIGURAÇÃO DE PROVEDORES SMS</mark>:*

1. Para cadastrar um provedor e lhe aplicar suas parametrizações pré-definidas, clique no botão “***\****”
2. Em *<mark style="color:blue;">Descrição</mark>* informe o nome do Provedor conforme sua necessidade de identificação no sistema;
3. Em *<mark style="color:blue;">Provedor</mark>* selecione o cadastro de parametrização de provedor, cadastrado em *<mark style="color:blue;">menu</mark>* *<mark style="color:blue;">Configurações >> PROVEDORES SMS</mark>*;
4. Em *<mark style="color:blue;">usuário</mark>* <mark style="color:blue;"></mark><mark style="color:blue;">e</mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">senha</mark>* informe o usuário e senha fornecidos pelo Provedor SMS para acesso e comunicação com a API;
5. Ao selecionar a opção “*<mark style="color:blue;">Este é o servidor padrão para envio de SMS’s</mark>*” o servidor informado será a referência quando selecionada a opção “<mark style="color:blue;">**PADRÃO**</mark>” para o envio de SMS;
6. Para testar se as configurações registradas estão corretas, clique no botão *>><mark style="color:blue;">TESTAR</mark>;*
7. Clique em *<mark style="color:blue;">Salvar</mark>* para concluir o cadastro.

## Configuração Telegram

Para utilização dos serviços de monitoramento por Telegram, previamente, crie um BOT diretamente no aplicativo TELEGRAM, conforme conceito deste aplicativo de mensagens.

\
Para aplicação desta configuração na ferramenta Weknow, siga os seguintes passos:

Abra o Weknow e acesse o menu: *<mark style="color:blue;">**Configurações**</mark>*<mark style="color:blue;">**&#x20;**</mark><mark style="color:blue;">**>>**</mark><mark style="color:blue;">**&#x20;**</mark>*<mark style="color:blue;">**BOTs do Telegram**</mark>*

<div align="left"><img src="/files/LkY9j9QuvW9McfIYOa8q" alt=""></div>

<div align="left"><img src="/files/S9bMAaxmnIx4pHBYR9BR" alt=""></div>

Para um novo registro de BOT a ser utilizado pela ferramenta, clique no botão “***\****”

Informe Descrição para identificação deste BOT em meio a utilização do Weknow. (Descrição livre a critério da instituição e área de negócio).

Informe qual o *<mark style="color:blue;">TOKEN</mark>* conforme repassado pelo cadastro no aplicativo Telegram

Ao selecionar a opção “*<mark style="color:blue;">Este é o BOT padrão para envio de mensagens</mark>*” o TOKEN do BOT TELEGRAM informado será a referência quando selecionada a opção “<mark style="color:blue;">**PADRÃO**</mark>” para o envio de telegram pela ferramenta Weknow.

Para testar se as configurações registradas estão corretas, clique no botão >><mark style="color:blue;">TESTAR</mark>.

Na sequência será solicitado um número de telefone celular para teste de envio, onde é necessário que possua o aplicativo Telegram e que já esteja credenciado ao BOT relacionado ao TOKEN indicado (Importante que já tenha indicado o comando START neste BOT, através do aplicativo Telegram).

Clique em *<mark style="color:blue;">Salvar</mark>* para concluir o cadastro.

Na sequência, configure o acesso do BOT telegram ao seu dispositivo/smatphone, autorizando e confirmando a sincronia entre BOT e número de telefone:

No App Telegram em seu smartphone ou tablet, pesquise seu BOT criado em etapa anterior no BotFather;

Clique em ‘*’<mark style="color:blue;">Começar</mark>*” (em alguns aparelhos pode se apresentar como “*START*”):

<div align="left"><img src="/files/gpxqnnb5DlL5ryzvfYQD" alt=""></div>

Uma vez cadastrado o BOT no app Weknow client, e após o BOT inicializado no aparelho, conforme etapa anterior, em alguns instantes aparecerá um *<mark style="color:blue;">**botão de compartilhamento de número no BOT visualizado no aparelho**</mark>*. Clique neste botão para *autorizar* o recebimento de mensagens por este BOT em seu aparelho:

<div align="left"><img src="/files/BKrqBKxjjjCwYAtTUKMK" alt=""></div>

<div align="left"><img src="/files/Bt9chCPCBqbsuwcOqHk2" alt=""></div>

Assim que o número autorizado estiver OK par recebimento de mensagens do BOT, será enviado ao chat com o bot o agradecimento pelo compartilhamento do contato.

Na sequência, caso teste via botão “TESTAR” no cadastro do BOT, será encaminhado texto de teste de envio, conforme imagem a seguir:

<div align="left"><img src="/files/IdbMLpCydUfGvFFmkHpS" alt=""></div>

A partir disto, tarefas que possuam este número e BOT vinculados simultaneamente, passarão a encaminhar dashboards ou componentes individuais em monitoramento periódico, ou quando atingida determinada condição reconhecida pelo Weknow.