
# 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](connecting-other-tools.md).

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 <span data-t="appName">DM Champ</span> dá às suas [automatizações](../automations/automations.md) 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](wordpress.md):

- 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 a saber antes de construir qualquer coisa. Todos os campos que aceitam etiquetas ou listas requerem os seus **números de ID**, separados por vírgulas, não os seus nomes. `1, 2` funciona; `Newsletter, VIP` não funciona.

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.

- **E-mail** é o endereço de e-mail do contacto. Obrigatório. Normalmente o e-mail do contacto proveniente do gatilho.
- **Nome**, **Apelido** e **Telefone** são opcionais.
- **Estado** é `subscribed`, `pending`, `unsubscribed` ou `bounced`. Se deixado vazio, é `subscribed`.
- **IDs de etiquetas** são as etiquetas a aplicar, 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 e-mail** anterior na automatização.
- **E-mail** é o e-mail do contacto. Obrigatório, porque o FluentCRM solicita o e-mail em cada atualização.
- **IDs de etiquetas** são as etiquetas a anexar, separadas por vírgulas. Obrigatório.
- **Estado** é opcional e assume o valor predefinido `subscribed`.

### Remover etiquetas do contacto

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

### Adicionar contacto a listas

- **ID de contacto**, **Email** e **IDs de lista** (separados por vírgulas), com o mesmo **Estado** opcional.

---

## 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 vêm depois de 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 seguem em frente.** Tudo o que uma ação devolve fica disponível para os passos seguintes como variáveis.
- **IDs, não nomes,** para todos os campos de etiqueta e lista. Um nome nesse campo simplesmente não corresponderá.
- **Alguns alojamentos removem o cabeçalho Authorization** 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 definitivamente corretos e a ligação continuar a ser recusada, é esse o ponto a verificar com o seu alojamento.
- **Não existe nenhum gatilho que monitorize o FluentCRM.** Nada verifica alterações. Para que o FluentCRM inicie uma automatização, adicione um gatilho de **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 de **Pedido HTTP**.

---

## Próximos Passos

- [Automatizações](../automations/automations.md): gatilhos, passos, condições e como um fluxo de trabalho é estruturado.
- [WordPress](wordpress.md): publicações e utilizadores no mesmo site, com os mesmos detalhes de ligação.
- [MemberPress](memberpress.md): adesões e pagamentos no seu site WordPress.
- [Ligar uma ferramenta que não listamos](connecting-other-tools.md): funções personalizadas, a API e webhooks.
