Atividades registadas num contacto
Cada atividade tem o mesmo nome que o respetivo trigger de workflow, e pode usar cada uma num passo Delay until event. Imagens, mensagens de voz, vídeos e documentos enviados pelo contacto não registam uma atividade Text Reply, por isso não disparam o trigger Text Reply.
Se criar relatórios ou integrações com a API do HubSpot, os nomes dos eventos são
flowella-form-completed, flowella-message-sent, flowella-message-seen e flowella-reply. No próprio HubSpot só vê as etiquetas acima.Propriedades de eventos para filtragem
Cada evento do Flowella inclui as propriedades abaixo. Pode usá-las como condições de filtro nos triggers de workflow do HubSpot, nas listas ativas e nos relatórios para o evento correspondente.messageType é um enum no evento Message Read com os valores TEXT, IMAGE, AUDIO, VIDEO, DOCUMENT, TEMPLATE, SYSTEM e OTHER. Descreve a mensagem enviada que foi lida.
Filtros típicos:
formName=Get Startedem Form Completed para disparar apenas com submissões de um formulário WhatsApp Flow específico.messageType=TEMPLATEem Message Read para isolar as confirmações de leitura dos seus envios de modelos.templateName=flowella_form_reminderem Message Sent para segmentar os contactos a quem foi enviado um modelo específico.
Não existe uma propriedade de direção. Message Sent e Message Read dizem sempre respeito a mensagens que enviou, e Text Reply é sempre uma mensagem do contacto. Filtre pelo próprio evento.
Estas propriedades são definidas no evento da cronologia. Nos triggers de workflow aparecem como campos filtráveis no evento do Flowella; nas listas ativas do HubSpot pode referenciá-las através do filtro de eventos da cronologia para o tipo de evento correspondente.
Propriedades de contacto Last WhatsApp reply
Além dos eventos da cronologia, o Flowella mantém duas propriedades de contacto que contêm sempre a resposta WhatsApp recebida mais recente do contacto:
Ambas as propriedades ficam no grupo Flowella Properties do registo do contacto. O Flowella cria o grupo e ambas as propriedades quando liga ou volta a ligar o HubSpot, se CRM contacts (auto-create on new WhatsApp chat) estiver desbloqueado em Settings → HubSpot. Se estiverem em falta, o Flowella cria-as da próxima vez que registar uma resposta.
O Flowella substitui ambas as propriedades sempre que regista uma atividade Text Reply: para mensagens de texto, toques em botões, escolhas em listas e submissões de Flows. Para uma submissão de Flow, Last WhatsApp reply message contém um resumo de uma linha da submissão.
O Flowella atualiza as propriedades antes de registar a atividade. Quando um trigger Text Reply é disparado, Last WhatsApp reply message já contém a mensagem que o disparou, por isso o seu workflow pode ramificar imediatamente com base na propriedade. Se o HubSpot continuar a rejeitar a atualização, o Flowella regista a atividade na mesma. As respostas com mais de 4.096 caracteres são cortadas nos primeiros 4.096.
Ramificar com base na propriedade, não na mensagem do evento
O HubSpot avalia filtros de eventos como Text Reply → Message contains face a todos os eventos Text Reply históricos do contacto, e não apenas ao mais recente. Assim que um contacto tiver alguma vez enviado uma resposta correspondente, o filtro corresponde para sempre. A propriedade de contacto evita isto porque só contém a resposta mais recente. O padrão recomendado é:- Inscrever o workflow com o evento Text Reply para que seja disparado quando chega uma nova mensagem recebida.
- Ramificar com base na propriedade de contacto Last WhatsApp reply message. Use igualdade exata para escolhas fixas como
Yes/No, ou “contains any of” para encaminhamento por palavra-chave.
O HubSpot mantém o histórico de alterações das propriedades, por isso os valores anteriores de Last WhatsApp reply message continuam visíveis no histórico da propriedade no registo do contacto. Inclua a propriedade em qualquer processo de retenção ou eliminação de dados que abranja o conteúdo das mensagens.
O que cada atividade regista
Form Completed
Registada quando um contacto conclui um formulário WhatsApp Flow. A atividade regista:- Form name: o nome do formulário concluído, por exemplo Get Started
- Source: sempre WhatsApp Flow
- Links: View submission, View in Flowella
Message Sent
Registada quando a Meta confirma que enviou uma mensagem WhatsApp do Flowella para o contacto. A atividade regista:- Phone: o número de telefone do contacto em formato E.164
- Status: Sent
- Template: o nome do modelo, por exemplo
flowella_form_reminder(só quando a mensagem foi um modelo) - Links: View template, Open in Inbox, View in Flowella
Message Read
Registada quando a Meta informa que o contacto leu uma mensagem do Flowella. A atividade regista:- Phone: o número de telefone do contacto em formato E.164
- Message type: o tipo de mensagem que foi lida, um de
TEXT,IMAGE,AUDIO,VIDEO,DOCUMENT,TEMPLATE,SYSTEMouOTHER - Time to read (seconds): quanto tempo depois de o Flowella enviar a mensagem o contacto a leu
- Links: View message in Flowella
Text Reply
Registada quando o contacto envia uma mensagem de texto, toca num botão, escolhe numa lista ou submete um Flow. A atividade regista:- Phone: o número de telefone do contacto em formato E.164
- Message: o conteúdo da resposta. Para uma submissão de Flow, um resumo de uma linha.
- Response time (seconds): o tempo entre a sua última mensagem na conversa e esta resposta
- Links: Open in Inbox, View in Flowella
Usar atividades em workflows
As mesmas quatro atividades alimentam os triggers de workflow do HubSpot do Flowella. Pode inscrever um contacto quando ocorre uma atividade, ou reter um contacto num passo Delay until event até que ocorra.O padrão mais eficaz é enviar e depois aguardar: envie um modelo, adicione um passo Delay until event definido para um evento do Flowella, como Form Completed, e depois ramifique consoante o evento tenha ocorrido no período escolhido. Consulte Ações de workflow para a configuração completa, incluindo como encaminhar com base no que um contacto respondeu usando a propriedade Last WhatsApp reply message.
Verificar se os eventos de atividade do contacto estão desbloqueados
O Flowella só regista estas atividades quando Contact activity events (message sent, read, replies, forms) está em Unlocked no cartão Capabilities em Settings → HubSpot. Precisa das permissões HubSpottimeline e analytics.behavioral_events.send.
Se estiver em Not available, volte a ligar o HubSpot e aprove as permissões.
Não existe nenhuma definição para colocar as atividades em pausa. Só param quando desliga o HubSpot, e as atividades que já estão na cronologia permanecem lá.
Links diretos a partir da cronologia
Cada atividade inclui links em que pode clicar diretamente a partir do cartão da atividade:- View in Flowella abre a conversa na caixa de entrada do Flowella, no número WhatsApp que a conversa usa, mesmo que a sua organização tenha vários números.
- Open in Inbox abre a conversa na caixa de entrada de conversas do HubSpot, para que um agente possa responder a partir do HubSpot. Só funciona quando o contacto tem uma conversa na caixa de entrada do HubSpot, por exemplo através do canal personalizado do Flowella.
- View submission (Form Completed) e View template (Message Sent, apenas mensagens de modelo) abrem uma janela no registo do contacto. Veja abaixo.
Janelas View submission e View template
As atividades Form Completed e as atividades Message Sent de modelos têm um link que abre uma janela no registo do contacto HubSpot. A sua equipa pode rever o que foi submetido, ou o que o contacto viu, sem mudar de separador.
O Flowella guarda uma cópia da submissão ou do modelo quando regista a atividade. A janela mostra o que o contacto submeteu ou viu, mesmo que edite o modelo ou o Flow mais tarde.
Cada link funciona durante 24 horas depois de o Flowella registar a atividade. Depois disso, a janela mostra Link expired, e abrir novamente a atividade mostra o mesmo link expirado. Para ver os detalhes mais tarde, use View in Flowella.
Prima Escape ou clique fora da janela para voltar à cronologia do contacto.
Encontrar atividades num contacto
Abra qualquer registo de contacto e veja a cronologia Activities. Os eventos do Flowella aparecem com a etiqueta Flowella: WhatsApp Forms Integration. Para ver apenas a atividade WhatsApp, filtre a cronologia por esse tipo de atividade. Para criar relatórios sobre a atividade WhatsApp, consulte Relatórios e dashboards.Relacionado
Ações de workflow
Configure triggers e ações do Flowella nos workflows do HubSpot.
Relatórios e dashboards
Crie relatórios sobre a atividade WhatsApp ao lado dos seus outros canais.
Canal personalizado
Traga as conversas WhatsApp para a caixa de entrada do HubSpot.
Usar a caixa de entrada
Leia e responda a conversas WhatsApp no Flowella.