Your AI Connector Docs

FluentCRM

Para quem é isto? Empresas que mantêm a sua lista de e-mail no FluentCRM no seu próprio site WordPress e querem que as conversas a alimentem. Se não utiliza o FluentCRM, pode ignorar esta página.

Utiliza um CRM ou ferramenta de e-mail diferente? Qualquer coisa com uma API pode ser ligada: consulte Ligar uma Ferramenta que Não Listamos.

O FluentCRM é um plugin de CRM e e-mail marketing que reside dentro do WordPress: contactos, etiquetas, listas e as campanhas que lhes envia. Ligá-lo ao Your AI Connector dá às suas automatizações passos que escrevem nele, para que um novo contacto de WhatsApp se torne um contacto do FluentCRM com a etiqueta correta, e a sequência de e-mail que já construiu assume o controlo a partir daí. Sem exportações, sem copiar e colar, sem esperar até sexta-feira.

Nada é instalado no seu site WordPress. Liga o seu próprio site com os seus próprios detalhes de início de sessão, e nós chamamos a API que o FluentCRM já expõe.

Disponibilidade: As Automatizações estão disponíveis em todas as contas. Já se encontram na sua barra lateral e não há nada para ativar ou solicitar.

O que precisa

O FluentCRM funciona sobre a API REST do WordPress, por isso utiliza exatamente os mesmos detalhes que a ligação ao WordPress:

  • O site WordPress onde o FluentCRM corre, acessível via https, no WordPress 5.6 ou mais recente.
  • Pretty permalinks ativados (Definições → Ligações permanentes, qualquer opção que não seja “Simples”), que é o que faz o endereço /wp-json/ funcionar.
  • Uma palavra-passe de aplicação para o utilizador WordPress em nome do qual a automatização deve agir: Utilizadores → Perfil → Palavras-passe de aplicação → Adicionar nova. O WordPress mostra-a uma vez, em blocos separados por espaços. Copie-a com os espaços.

Esse utilizador precisa de ter permissão para gerir o FluentCRM no WordPress. A sua palavra-passe de início de sessão real nunca é utilizada, e eliminar a palavra-passe de aplicação mais tarde revoga exatamente esta ligação.

Ligar o FluentCRM

Liga-se a partir do interior de uma automatização, na primeira vez que utiliza um passo do FluentCRM.

  1. Abra Automatizações na barra lateral (sob o grupo AI Studio) e abra ou crie uma automatização.
  2. Adicione um passo e procure por FluentCRM no seletor de passos.
  3. Escolha a ação que pretende. O passo pede-lhe para ligar primeiro.
  4. Preencha os três campos:
    • URL do site é o endereço do site WordPress onde o FluentCRM corre, começando com https://.
    • Nome de utilizador WordPress é o nome de utilizador com que esse utilizador inicia sessão, não o seu e-mail.
    • Palavra-passe de aplicação é a palavra-passe que criou acima, colada com os seus espaços.
  5. Clique em ligar.

Verificamos os detalhes no seu site antes de guardar qualquer coisa, lendo um contacto do FluentCRM. Detalhes incorretos, ou um site onde o /wp-json/ não resolve, são recusados no ecrã com o motivo. A sua palavra-passe de aplicação é armazenada encriptada e nunca lhe é mostrada novamente.

As Etiquetas e Listas São Fornecidas como IDs

Esta é a única coisa que precisa de saber antes de construir o que quer que seja. Todos os campos que aceitam etiquetas ou listas requerem os seus números de ID, separados por vírgulas, e não os seus nomes. 1, 2 funciona; Newsletter, VIP não funciona, e o editor assinala-o no campo. Um ID que apenas se revela incorreto quando a automatização é executada (por exemplo, um que tenha vindo de um passo anterior) interrompe o passo com um erro, em vez de ser executado silenciosamente sem essa etiqueta.

Encontrará os números no FluentCRM: abra Etiquetas ou Listas no menu do FluentCRM, e o ID de cada linha encontra-se na barra de endereços quando a abre. Anote o punhado que planeia utilizar uma vez, e está feito.

As Ações

Cada ação é um passo na tela de automatização, e todos os campos aceitam dados de passos anteriores com os habituais botões de inserção de dados.

Criar ou atualizar contacto

Adiciona um contacto ou atualiza aquele que já possui este e-mail. Enviar o mesmo e-mail duas vezes atualiza o contacto em vez de falhar, pelo que pode executar isto em cada novo lead sem verificar primeiro.

  • Email é o endereço de correio eletrónico do contacto. Obrigatório. Normalmente, o email do contacto proveniente do acionador.
  • Nome próprio, Apelido e Telefone são opcionais.
  • Estado é escolhido a partir de uma lista: Subscrito, Pendente, Não subscrito ou Transacional. Obrigatório, porque o FluentCRM necessita de um, e aplica-se também a contactos existentes: Subscrito volta a subscrever alguém que tinha cancelado a subscrição, por isso escolha-o apenas quando a pessoa pediu para aderir. Pendente envia o email de dupla confirmação (double opt-in) do FluentCRM.
  • IDs de etiquetas são as etiquetas a atribuir, separadas por vírgulas. Opcional.
  • IDs de listas são as listas às quais os adicionar, separadas por vírgulas. Opcional.

Encontrar contacto por e-mail

Procura um contacto pelo endereço de e-mail e devolve o seu ID, as suas etiquetas e as suas listas.

  • E-mail é o endereço a procurar. Obrigatório.

O seu resultado é o que os passos seguintes necessitam, uma vez que funcionam com base num ID de contacto.

Adicionar etiquetas ao contacto

Anexa uma ou mais etiquetas a um contacto que já existe.

  • ID do contacto é o contacto em questão. Obrigatório. Normalmente obtido a partir de um passo Encontrar contacto por email anterior na automatização.
  • Email é o email do contacto. Obrigatório, porque o FluentCRM solicita o email em cada atualização.
  • IDs de etiquetas são as etiquetas a anexar, separadas por vírgulas. Obrigatório.
  • Alterar estado é opcional. Se for deixado em Manter estado atual, o estado do contacto não é alterado, pelo que etiquetar alguém que cancelou a subscrição não o subscreve novamente.

Remover etiquetas do contacto

Os mesmos campos, removendo etiquetas em vez de as adicionar.

Adicionar contacto a listas

  • ID do contacto, Email e IDs de listas (separados por vírgulas), com a mesma opção Alterar estado.

Um exemplo de automatização

Cada novo lead do WhatsApp entra no FluentCRM, com uma etiqueta que indica a sua origem.

  1. Gatilho: mensagem recebida de um novo contacto.
  2. Criar ou atualizar contacto, com o email, nome próprio e telefone do contacto provenientes do gatilho, e o ID de lista da sua lista principal.
  3. Adicionar etiquetas ao contacto não é necessário aqui, porque o passo 2 já pode incluir os IDs de etiqueta. Utilize-o quando a etiqueta surgir mais tarde na conversa.

E a versão em que a etiqueta surge mais tarde, que é a mais útil:

  1. Gatilho: uma etiqueta é adicionada ao contacto, por exemplo asked about pricing, pelo seu agente de IA.
  2. Encontrar contacto por email, com o email do contacto.
  3. Adicionar etiquetas ao contacto, utilizando o ID do passo 2, o mesmo email e o ID de etiqueta do FluentCRM para a sua sequência de preços.

A automatização do próprio FluentCRM envia então a sequência de emails que essa etiqueta inicia. A conversa acontece no WhatsApp, a nutrição acontece por email e ninguém move uma linha entre eles manualmente.

É bom saber

  • Os passos que requerem um ID de contacto surgem após um passo de Procura. Essa é a estrutura normal: encontrar o contacto e, em seguida, agir sobre o ID que o passo de procura devolveu.
  • Os resultados avançam. Tudo o que uma ação devolve fica disponível para passos posteriores como variáveis.
  • IDs, não nomes, para todos os campos de etiquetas e listas. Um nome nesse campo é assinalado no editor e interrompe o passo quando este é executado.
  • Alguns alojamentos removem o cabeçalho de Autorização antes de o WordPress o ver, o que faz com que uma palavra-passe de aplicação correta pareça errada. Se os seus dados estiverem certamente corretos e a ligação continuar a ser recusada, é esse o ponto a questionar junto do seu alojamento.
  • Não existe nenhum acionador que monitorize o FluentCRM. Nada o consulta para verificar alterações. Para que o FluentCRM inicie uma automatização, adicione um acionador Webhook à automatização e aponte um webhook de saída do FluentCRM para o endereço que este lhe fornecer.
  • Qualquer coisa que não esteja na lista acima ainda pode ser feita com o passo Pedido HTTP.

Próximos Passos