Mudanças entre as edições de "PHWhatsApp"
Linha 38: | Linha 38: | ||
|numero | |numero | ||
|String | |String | ||
− | |Número do destinatário da mensagem. | + | |Número do destinatário da mensagem (DDI+DDD+Número). |
|- | |- | ||
|mensagem | |mensagem | ||
Linha 50: | Linha 50: | ||
====Exemplo de utilização==== | ====Exemplo de utilização==== | ||
+ | |||
+ | procedure EnviarMensagemWhatsApp; | ||
+ | var | ||
+ | REST: TPHConexaoREST; | ||
+ | begin | ||
+ | Rest := NewPHConexaoREST; | ||
+ | try | ||
+ | // Envio via 'GET' | ||
+ | Rest.Metodo := 'GET'; | ||
+ | |||
+ | // URL = Host do servidor + Porta + EndPoint | ||
+ | Rest.URL := 'http://localhost:8083/enviarMensagemTexto'; | ||
+ | |||
+ | // Informar no cabeçalho os dados criptografados do serviço | ||
+ | Rest.AddHeader('Authorization', 'Basic cGhzeXM6MTIzNDU2Nzg5'); | ||
+ | |||
+ | // número de destino da mensagem | ||
+ | Rest.AddParametro('numero', '554797473192'); | ||
+ | |||
+ | // mensagem a ser enviada | ||
+ | Rest.AddParametro('mensagem', 'Tcxxceste de envio de mensagem no whatsapp'); | ||
+ | |||
+ | Rest.Executar; | ||
+ | |||
+ | if not Rest.RetornoErro then | ||
+ | informacao(Rest.Retorno) | ||
+ | else | ||
+ | ErroValidacao(Rest.Retorno); | ||
+ | finally | ||
+ | REST.Free; | ||
+ | end; | ||
+ | end; |
Edição das 15h08min de 30 de março de 2021
Índice
Conceito
O PHWhatsApp é um integrador do PH ERP que permite realizar o envio de mensagens WhatsApp por meio de API.
Nota
Para utilizar o integrador é necessário entrar em contato com o suporte para solicitar a instalação do serviço do PHWhatsApp em seu servidor. |
Configurando o Serviço
Após a instalação do PHWhatsApp é necessário realizar as configurações do servidor, para isso temos que executar o arquivo PHWhatsApp.exe que está na pasta de instalação do PHWhatsApp. Na aba Serviço é possível configurar os dados de acesso da API da integração.
Campos
- Porta: Identificação da porta liberada para realizar o acesso a API.
- Usuário: Usuário que será utilizado para realizar a autenticação no serviço.
- Senha: Senha que será utilizada para realizar a autenticação no serviço.
- Authorization: Campo leitura que contém os dados de acesso criptografados para a autenticação no servidor.
Opções
- Autenticar Dispositivo: Essa opção permite realizar a leitura do QRCode do WhatsApp Web para autenticar o dispositivo.
- Iniciar: Inicia o serviço de aplicação do PHWhatsApp.
- Parar: Interrompe a execução do serviço do PHWhatsApp.
- Reiniciar: Reinicia o serviço do PHWhatsApp.
API
- Método: GET.
- Autenticação: Basic (Usuário e Senha).
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
numero | String | Número do destinatário da mensagem (DDI+DDD+Número). |
mensagem | String | Mensagem que será enviada |
Consumindo a API
Após realizar a configuração do servidor de aplicação, com o serviço iniciado podemos consumir através de script do PHERP a API do PHWhatsApp, para isso utilizaremos o objeto TPHConexaoREST.
Exemplo de utilização
procedure EnviarMensagemWhatsApp; var REST: TPHConexaoREST; begin Rest := NewPHConexaoREST; try // Envio via 'GET' Rest.Metodo := 'GET';
// URL = Host do servidor + Porta + EndPoint Rest.URL := 'http://localhost:8083/enviarMensagemTexto';
// Informar no cabeçalho os dados criptografados do serviço Rest.AddHeader('Authorization', 'Basic cGhzeXM6MTIzNDU2Nzg5');
// número de destino da mensagem Rest.AddParametro('numero', '554797473192');
// mensagem a ser enviada Rest.AddParametro('mensagem', 'Tcxxceste de envio de mensagem no whatsapp'); Rest.Executar;
if not Rest.RetornoErro then informacao(Rest.Retorno) else ErroValidacao(Rest.Retorno); finally REST.Free; end; end;