
# FluentCRM

> **Para quem é isso?** Empresas que mantêm sua lista de e-mail no FluentCRM em seu próprio site WordPress e desejam que as conversas a alimentem. Se você não usa o FluentCRM, pode pular esta página.
>
> Usa um CRM ou ferramenta de e-mail diferente? Qualquer coisa com uma API ainda pode ser conectada: veja [Conectando 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: contatos, tags, listas e as campanhas que você envia para eles. Conectá-lo ao <span data-t="appName">DM Champ</span> dá às suas [automações](../automations/automations.md) etapas que escrevem nele, para que um novo lead do WhatsApp se torne um contato do FluentCRM com a tag correta, e a sequência de e-mail que você já criou assuma o controle a partir daí. Sem exportação, sem copiar e colar, sem esperar até sexta-feira.

Nada é instalado no seu site WordPress. Você conecta seu próprio site com seus próprios detalhes de login, e nós chamamos a API que o FluentCRM já expõe.

**Disponibilidade:** Automações estão disponíveis em todas as contas. Já está na sua barra lateral e não há nada para habilitar ou solicitar.

---

## O que você precisa

O FluentCRM utiliza a API REST do WordPress, portanto, ele requer exatamente os mesmos detalhes que a conexão do [WordPress](wordpress.md):

- O **site WordPress onde o FluentCRM é executado**, acessível via **https**, no WordPress **5.6 ou mais recente**.
- **Links permanentes amigáveis** ativados (**Configurações → Links permanentes**, qualquer opção que não seja "Padrão"), que é o que faz o endereço `/wp-json/` funcionar.
- Uma **senha de aplicativo** para o usuário do WordPress como o qual a automação deve agir: **Usuários → Perfil → Senhas de Aplicativo → Adicionar Nova**. O WordPress a mostra uma vez, em blocos separados por espaços. Copie-a com os espaços.

Esse usuário precisa ter permissão para gerenciar o FluentCRM no WordPress. Sua senha de login real nunca é usada, e excluir a senha de aplicativo posteriormente revoga exatamente esta conexão.

---

## Conectando o FluentCRM

Você se conecta de dentro de uma automação, na primeira vez que usa uma etapa do FluentCRM.

1. Abra **Automações** na barra lateral (sob o grupo **AI Studio**) e abra ou crie uma automação.
2. Adicione uma etapa e pesquise por **FluentCRM** no seletor de etapas.
3. Escolha a ação que deseja. A etapa solicitará que você se conecte primeiro.
4. Preencha os três campos:
   - **URL do site** é o endereço do site WordPress onde o FluentCRM é executado, começando com `https://`.
   - **Nome de usuário do WordPress** é o nome de usuário com o qual o usuário faz login, não o e-mail dele.
   - **Senha de aplicativo** é a senha que você criou acima, colada com seus espaços.
5. Clique em conectar.

Verificamos os detalhes em seu site antes de salvar qualquer coisa, lendo um contato do FluentCRM. Detalhes incorretos, ou um site onde `/wp-json/` não é resolvido, são recusados na tela com o motivo. Sua senha de aplicativo é armazenada criptografada e nunca é exibida novamente para você.

---

## Tags e Listas São Fornecidas como IDs

Esta é a única coisa a saber antes de construir qualquer coisa. Cada campo que aceita tags ou listas deseja seus **números de ID**, separados por vírgula, não seus nomes. `1, 2` funciona; `Newsletter, VIP` não funciona.

Você encontrará os números no FluentCRM: abra **Tags** ou **Listas** no menu do FluentCRM, e o ID de cada linha estará na barra de endereços quando você a abrir. Anote os poucos que planeja usar uma vez e pronto.

---

## As Ações

Cada ação é uma etapa na tela de automação, e todos os campos aceitam dados de etapas anteriores com os botões usuais de inserção de dados.

### Criar ou atualizar contato

Adiciona um contato ou atualiza aquele que já possui este e-mail. Enviar o mesmo e-mail duas vezes os atualiza em vez de falhar, portanto, você pode executar isso em cada novo lead sem verificar primeiro.

- **E-mail** é o endereço de e-mail do contato. Obrigatório. Geralmente o e-mail do contato proveniente do gatilho.
- **Nome**, **Sobrenome** e **Telefone** são opcionais.
- **Status** é `subscribed`, `pending`, `unsubscribed` ou `bounced`. Se deixado vazio, é `subscribed`.
- **IDs de etiquetas** são as etiquetas a serem aplicadas a eles, separadas por vírgula. Opcional.
- **IDs de listas** são as listas às quais adicioná-los, separadas por vírgula. Opcional.

### Encontrar contato por e-mail

Pesquisa um contato pelo endereço de e-mail e retorna seu ID, suas etiquetas e suas listas.

- **E-mail** é o endereço a ser pesquisado. Obrigatório.

Sua saída é o que as etapas abaixo precisam, pois elas operam com um ID de contato.

### Adicionar etiquetas ao contato

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

- **ID do contato** é qual contato. Obrigatório. Normalmente obtido de uma etapa de **Encontrar contato por e-mail** anteriormente na automação.
- **E-mail** é o e-mail do contato. Obrigatório, pois o FluentCRM solicita o e-mail em cada atualização.
- **IDs de etiquetas** são as etiquetas a serem anexadas, separadas por vírgula. Obrigatório.
- **Status** é opcional e o padrão é `subscribed`.

### Remover etiquetas do contato

Os mesmos campos, removendo etiquetas em vez de adicioná-las.

### Adicionar contato a listas

- **ID do Contato**, **E-mail** e **IDs da Lista** (separados por vírgula), com o mesmo **Status** opcional.

---

## Um Exemplo de Automação

**Todo novo lead do WhatsApp entra no FluentCRM, marcado com uma tag de acordo com sua origem.**

1. **Gatilho:** mensagem recebida de um novo contato.
2. **Criar ou atualizar contato**, com o e-mail, primeiro nome e telefone do contato vindos do gatilho, e o **ID da Lista** da sua lista principal.
3. **Adicionar tags ao contato** não é necessário aqui, pois a etapa 2 já pode carregar os **IDs das Tags**. Use-a quando a tag vier mais tarde na conversa.

E a versão onde a tag vem mais tarde, que é a mais útil:

1. **Gatilho:** uma tag é adicionada ao contato, digamos `asked about pricing`, pelo seu agente de IA.
2. **Encontrar contato por e-mail**, com o e-mail do contato.
3. **Adicionar tags ao contato**, usando o ID da etapa 2, o mesmo e-mail e o ID da tag do FluentCRM para sua sequência de preços.

A própria automação do FluentCRM então envia a sequência de e-mails que aquela tag inicia. A conversa acontece no WhatsApp, o relacionamento acontece por e-mail, e ninguém precisa mover uma linha entre eles manualmente.

---

## É bom saber

- **Etapas que exigem um ID de contato vêm após uma etapa de Localização.** Esse é o formato normal: encontre o contato e, em seguida, execute uma ação no ID que a etapa de localização retornou.
- **As saídas seguem adiante.** Tudo o que uma ação retorna fica disponível para as etapas posteriores como variáveis.
- **IDs, não nomes,** para cada campo de tag e lista. Um nome nesse campo simplesmente não corresponderá.
- **Alguns servidores removem o cabeçalho Authorization** antes que o WordPress o veja, o que faz com que uma senha de aplicativo correta pareça incorreta. Se seus detalhes estiverem definitivamente corretos e a conexão ainda for recusada, esse é o ponto a ser verificado com seu provedor de hospedagem.
- **Não existe um gatilho que monitore o FluentCRM.** Nada faz sondagens (polling) em busca de alterações. Para fazer com que o FluentCRM inicie uma automação, adicione um gatilho de **Webhook** à automação e aponte um webhook de saída do FluentCRM para o endereço fornecido.
- **Qualquer coisa que não esteja na lista acima** ainda pode ser feita com a etapa de **Requisição HTTP**.

---

## Próximos passos

- [Automações](../automations/automations.md): gatilhos, etapas, condições e como um fluxo de trabalho é montado.
- [WordPress](wordpress.md): posts e usuários no mesmo site, com os mesmos detalhes de conexão.
- [MemberPress](memberpress.md): assinaturas e pagamentos no seu site WordPress.
- [Conectando uma Ferramenta que Não Listamos](connecting-other-tools.md): funções personalizadas, a API e webhooks.
