Os agentes do RBM recebem mensagens e eventos por um webhook. Quando um usuário envia uma mensagem ao seu agente, o serviço RBM do Google envia a mensagem ao webhook configurado. Em seguida, o agente pode decodificar a mensagem, processá-la e emitir uma resposta ao usuário.
Os usuários podem enviar qualquer texto, local ou arquivo que o cliente RCS permitir. O agente precisa processar qualquer texto, local ou arquivo que o usuário possa enviar, bem como qualquer estado de erro que essas mensagens possam acionar.
Para saber como o agente pode processar confirmações de entrega, confirmações de leitura e indicadores de digitação, consulte Receber eventos.
Processar mensagens recebidas
A forma como o agente processa e responde às mensagens dos usuários depende muito da lógica de negócios. No entanto, as etapas para responder a uma mensagem do usuário são consistentes.
Etapa 1: identificar o tipo de mensagem enviada pelo usuário
Os usuários podem enviar quatro tipos de mensagens:
- As mensagens de texto são respostas de forma livre.
- Sugestão mensagens incluem os dados de postback e o texto de a ação sugerida ou resposta sugerida que o usuário tocou.
As mensagens de localização incluem valores de latitude e longitude.
As mensagens de arquivo incluem o URI de um arquivo e os dados associados.
Etapa 2: processar o conteúdo da mensagem
O conteúdo da mensagem do usuário deve orientar a lógica do agente e a próxima resposta na conversa.
A maneira mais fácil de identificar a intenção do usuário é com dados de postback de uma resposta ou ação sugerida. Independente do texto associado à sugestão, os dados de postback são legíveis por máquina.
Se um usuário enviar uma mensagem de texto, o agente poderá analisar a resposta para palavras-chave compatíveis ou usar o NLU (como o Dialogflow) para processar a mensagem do usuário e identificar um caminho a seguir.
As mensagens de localização e arquivo não incluem texto ou dados de postback. Portanto, o agente precisa considerar o contexto da conversa e as mensagens recentes antes de responder.
Se o agente não souber como responder à mensagem do usuário, ele deverá responder com um estado de erro e tentar continuar a conversa solicitando mais informações do usuário, pedindo a entrada de dados de outra forma ou apresentando respostas e ações sugeridas que o agente sabe como responder.
Etapa 3: atender à lógica de negócios da interação
Depois que o agente identifica a resposta correta à mensagem do usuário, ele coleta as informações necessárias da sua infraestrutura e interage com outros sistemas conforme necessário para atender à lógica de negócios da interação.
Etapa 4: responder ao usuário
Depois que o agente atende à lógica de negócios da interação, ele envia outra mensagem e continua a conversa com o usuário.
Exemplos
O código a seguir mostra como o agente recebe mensagens. Para informações de formatação e valor, consulte UserMessage.
O agente recebe texto
{
"agentId": "AGENT_ID",
"senderPhoneNumber": "PHONE_NUMBER",
"messageId": "MESSAGE_ID",
"sendTime": "2018-12-31T15:01:23.045123456Z",
"text": "Hello, world!"
}O agente recebe uma mensagem de uma sugestão
{
"agentId": "AGENT_ID",
"senderPhoneNumber": "PHONE_NUMBER",
"messageId": "MESSAGE_ID",
"sendTime": "2018-12-31T15:01:23.045123456Z",
"suggestionResponse": {
"postbackData": "suggestion_1",
"text": "Suggestion #1"
}
}O agente recebe um local
{
"agentId": "AGENT_ID",
"senderPhoneNumber": "PHONE_NUMBER",
"messageId": "MESSAGE_ID",
"sendTime": "2018-12-31T15:01:23.045123456Z",
"location": {
"latitude": 37.422000,
"longitude": -122.084056
}
}O agente recebe um arquivo
{ "agentId": "AGENT_ID", "senderPhoneNumber": "PHONE_NUMBER", "messageId": "MESSAGE_ID", "sendTime": "2018-12-31T15:01:23.045123456Z", "userFile": { "thumbnail": { "mimeType": "image/jpeg", "fileSizeBytes": 1280, "fileUri": "https://storage.googleapis.com/copper_test/77ddb795-24ad-4607-96ae-b08b4d86406a/d2dcc67ab888d34ee272899c020b13402856f81597228322079eb007e8c8", "fileName": "4_animated.jpeg" }, "payload": { "mimeType": "image/gif", "fileSizeBytes": 127806, "fileUri": "https://storage.googleapis.com/copper_test/77ddb795-24ad-4607-96ae-b08b4d86406a/d2dcc67ab888d34ee272899c020b13402856f81597228322079eb007e8c9", "fileName": "4_animated.gif" } } }