User Tools

Site Tools


br-050-user-message


Recebendo mensagens de usuários

Na parte inferior da lista de mensagens do dispositivo móvel, o APP apresenta uma caixa de texto onde o usuário pode enviar mensagens para a aplicação associada ao canal. Essa caixa de texto só é apresentada no APP quando o desenvolvedor preenche o atributo Response message URL, na inclusão do canal. Caso esse atributo não seja informado, a caixa de texto é omitida.

O recebimento de mensagens de usuários pode ser usado em várias situações, como nos exemplos abaixo:

Quando o usuário solicita uma informação para a aplicação:

  1. O usuário envia a mensagem: “pedido 12345” …
  2. A aplicação recebe a mensagem e responde: “Clique aqui para rastrear seu pedido 12345” …
  3. O usuário clica na resposta e abre a URL associada à mensagem para rastrear seu pedido.

Quando a aplicação envia uma mensagem e aguarda uma resposta do usuário (ou não):

  1. A aplicação envia a mensagem: “Compra de R$ 100,00 com o cartão final 5678. Responda B5678 para bloquear o cartão.” …
  2. O usuário recebe a mensagem e responde: “B5678” …
  3. A aplicação recebe a resposta do usuário e processa o bloqueio do cartão.



Variáveis POST

A mensagem enviada pelo usuário chega até a URL da aplicação por meio de um POST contendo 2 variáveis:

fzupidchannel Identificação do canal que está recebendo a mensagem (não criptografado).
fzupresponse String contendo a data/hora, User-ID e mensagem do usuário (criptografado).

Para decriptar o string contido no parâmetro fzupresponse, a aplicação deve fazer uso do método decrypt contido na API do canal, conforme exemplo abaixo:

PHP
$encrypt_string = $_POST["fzupresponse"];
$usermessage = $object -> decrypt ( $encrypt_string ); 
JAVA
String encrypt_string = httpServletRequest.getParameter("fzupresponse");
String usermessage = object.decrypt ( encrypt_string ); 
RUBY
encrypt_string = params[:fzupresponse]
usermessage = object.decrypt ( encrypt_string )
PERL
my $encrypt_string = $post->param('fzupresponse');
my $usermessage = $object -> decrypt ( $encrypt_string ); 
PYTHON
encrypt_string = request.args['fzupresponse']
usermessage = object.decrypt ( encrypt_string )


Nos exemplos acima, a mensagem do usuário armazenada na variável usermessage contém a seguinte string:

Conteúdo da string:
YYYY-MM-DD HH:MM:SS;User-ID;Text-message

Onde:
YYYY-MM-DD HH:MM:SS = Data e hora de envio da mensagem
User-ID = Identificação do usuário
Text-message = Texto da mensagem


br-050-user-message.txt · Last modified: 2017/04/20 16:13 by admin

Page Tools