Este guia explica como instalar, configurar, usar e desinstalar o aplicativo Smart workflow-App, a integração da SmartTalks.ai com o HubSpot. Com ele, você envia templates de mensagem da SmartTalks.ai a partir de fluxos de trabalho (workflows) do HubSpot.
Antes de instalar, confirme que você tem:
A instalação usa o fluxo de autorização (OAuth) da HubSpot. A SmartTalks.ai nunca recebe a senha da sua conta HubSpot.
Acesse o endereço abaixo no navegador:
https://app.smarttalks.ai/#/?hubspot_oauth=prod
Se ainda não estiver autenticado, entre com o login e a senha da sua conta SmartTalks.ai.
Uma mensagem avisa que a sua conta SmartTalks.ai será conectada ao HubSpot e que você será redirecionado para autorizar a conexão. Clique em OK.

Na tela da HubSpot, clique em Sign in to your HubSpot account e faça login.

Se você tem acesso a mais de uma conta HubSpot, selecione aquela em que o aplicativo será instalado e clique em Escolher conta.

A HubSpot lista o que o aplicativo poderá acessar. Revise a lista (veja a seção Escopos solicitados) e clique em Conectar aplicativo.

Dependendo do estado de verificação do aplicativo na HubSpot, pode ser exibido o aviso de aplicativo não verificado. Nesse caso, digite o texto solicitado na tela e clique em Conectar.

Ao final, a mensagem "HubSpot conectado! Sua conta foi autorizada com sucesso." é exibida. A instalação está concluída.

Na instalação, a HubSpot pede as permissões abaixo. Todas são obrigatórias para o funcionamento do aplicativo.
| Permissão exibida na HubSpot | Para que serve |
|---|---|
| Exibir as propriedades e outros detalhes sobre os contatos | Ler propriedades dos contatos, como o telefone e os valores usados nas variáveis do template |
| Ver propriedades sobre a conta de instalação, incluindo domínio e e-mails dos usuários | Identificar a conta HubSpot em que o aplicativo está instalado e vinculá-la à sua conta SmartTalks.ai |
| Visualizar, criar, excluir ou editar atividades personalizadas do objeto de CRM | Registrar no HubSpot as atividades geradas pelo envio de templates |
Depois de instalado, o aplicativo aparece como uma ação personalizada nos fluxos de trabalho do HubSpot.
No menu lateral do HubSpot, acesse Automação > Fluxos de trabalho e crie um fluxo novo ou abra um existente.

No fluxo, clique em adicionar ação. Na seção Aplicativos integrados, expanda Smart workflow-App e escolha Enviar template.

Preencha os campos conforme as informações da sua conta SmartTalks.ai:
| Campo | Descrição |
|---|---|
| Template | Template de mensagem que será enviado ao contato |
| Fluxo | Fluxo da SmartTalks.ai em que o contato será colocado |
| Bloco | Bloco do fluxo em que o contato começa |
| Número de Telefone | Propriedade do contato no HubSpot que contém o telefone de destino |
| Variável 1, 2, 3 | Propriedades do contato usadas para preencher as variáveis do template |
Ao terminar, clique em Salvar e ative o fluxo de trabalho.

No HubSpot, clique no ícone do marketplace, no topo da tela, e escolha Aplicativos conectados.

Na linha do Smart workflow-App, clique em Ações e depois em Desinstalar.

Digite desinstalar no campo de confirmação e clique em Desinstalar.

Para dúvidas sobre a integração com o HubSpot: