Pular para o conteúdo principal

ClickUp Lead Sync

ClickUp Lead Sync icon
Integração

Transforma leads e pedidos das suas conversas no MonoChat em tarefas no ClickUp e traz de volta ao MonoChat o que a sua equipe muda no ClickUp: uma mensagem ao cliente, uma nota, uma tag, um evento para os seus fluxos, campos do perfil e comentários.

  • ClickUp
  • WhatsApp
  • Leads
  • Pedidos
Instalar pela MonoStoreVer em monochat.ai

Visão geral​

O ClickUp Lead Sync conecta as suas conversas do MonoChat ao seu ClickUp. Leads e pedidos dos seus chats viram tarefas no ClickUp, preenchidas do jeito que a sua equipe trabalha, e o que a sua equipe muda no ClickUp volta para o MonoChat: uma mensagem ao cliente, uma nota para a equipe, uma tag, um evento para os seus próprios fluxos, campos do perfil e comentários.

Você decide quais conversas viram leads (Lead rules, Regras de leads), para onde vão os pedidos e como o app fica sabendo que foram pagos (Order flow, Fluxo de pedidos), e o que o MonoChat faz quando algo muda no ClickUp (Reactions, Reações). As telas Today (Hoje) e Activity (Atividade) mostram tudo o que o app fez, e um cartão ClickUp ao lado de cada conversa mostra as tarefas do cliente.

Destaques​

  • Chats viram leads no ClickUp. Uma nova conversa, a primeira mensagem de um novo cliente, uma tag, um campo do perfil, um formulário de Lead Ads ou o seu assistente de IA cria uma tarefa na lista que você escolher. Quando o mesmo cliente já tem uma tarefa aberta da regra, o app adiciona um comentário a ela em vez de criar uma nova tarefa.
  • O ClickUp muda, o MonoChat responde. Quando o status de uma tarefa passa para o que você escolheu, uma condição de campo é atendida ou um pedido é pago, o MonoChat pode enviar uma mensagem ao cliente, escrever uma nota para a equipe, adicionar ou remover tags, atribuir ou encerrar a conversa, ou iniciar os seus próprios fluxos com um evento personalizado.
  • Campos e comentários nos dois sentidos. Um campo mapeado de nome, telefone, e-mail ou perfil do CRM pode ser definido como Both ways (Nos dois sentidos), para que uma mudança de um lado atualize o outro. Um novo comentário no ClickUp vira uma nota na conversa, e uma nota que a sua equipe adiciona ao cliente vira um comentário na tarefa aberta.
  • Teste com segurança. O Test mode (Modo de teste), e o Whisper only (somente nota interna) em uma única regra ou reação, não grava nada no ClickUp e não envia nada aos clientes: cada etapa é registrada como uma nota interna na conversa.

Antes de começar​

Você precisa de:

  1. Um token de API pessoal do ClickUp. No ClickUp: seu avatar › Settings › Apps › API Token › Generate (ou Copy). Ele começa com pk_. O app age como essa pessoa: as tarefas e os comentários aparecem com o nome dela.
  2. Uma lista do ClickUp para os seus leads, e outra para os seus pedidos se quiser usar o fluxo de pedidos.
  3. Um canal conectado no MonoChat (WhatsApp, Instagram, Messenger, chat do site …). Para enviar mensagens aos clientes depois da janela de 24 horas, um modelo de WhatsApp aprovado nesse canal.
informação

O ClickUp não consegue chamar o MonoChat, por isso o app lê as mudanças das listas que usa a cada 1, 5 ou 15 minutos (General › Read ClickUp every, Ler o ClickUp a cada). Cada leitura usa uma requisição ao ClickUp por lista. Quando o ClickUp pede ao app para desacelerar, o trabalho espera e continua sozinho.

Plano Free do ClickUp

No plano Free do ClickUp, os campos personalizados só podem ser usados um número limitado de vezes. Quando o limite é atingido, o app continua criando a tarefa, escreve os valores dos campos na descrição dela e avisa você na tela Today (Hoje).

Instalação e configuração​

  1. Instale o ClickUp Lead Sync em Configurações › MonoStore › Aplicativos, ou abra o link de instalação app.monochat.ai/apps/v3SaNfhuHhuXb4Hrx. Se você não tem uma conta MonoChat, o link permite se cadastrar primeiro e instala o app para você.
  2. Abra o painel ClickUp (o ícone do ClickUp no menu à esquerda). Em Connection (Conexão), cole o seu ClickUp API token (token de API do ClickUp), clique em Test (Testar) e escolha o Workspace com as suas listas. Clique em Save (Salvar).
  3. Em Lead rules (Regras de leads), clique em New lead rule (Nova regra de leads): escolha o gatilho, os filtros e a lista do ClickUp, e como a tarefa é preenchida. Clique em Save.
  4. Opcional: em Order flow (Fluxo de pedidos), escolha a lista de pedidos e como o app fica sabendo que um pedido foi pago.
  5. Opcional: em Reactions (Reações), clique em New reaction (Nova reação) para decidir o que o MonoChat faz quando uma tarefa muda no ClickUp.
  6. Ative o Test mode (Modo de teste) em General se quiser testar tudo primeiro em conversas reais. Depois clique no botão verde de ligar no cabeçalho do painel e em Turn on (Ativar). O selo ao lado do título muda de Off (Desligado) para On (Ligado).
dica

Carregue os Sample data (Dados de exemplo) para ver todas as telas preenchidas antes do seu primeiro lead. Os dados de exemplo nunca são gravados no ClickUp e nunca enviam nada; Remove sample data (Remover dados de exemplo) tira todas as linhas de exemplo e mantém as suas regras, reações e tarefas reais.

Tela por tela​

O app fica no painel ClickUp do menu à esquerda: Today (Hoje), Leads, Orders (Pedidos), Lead rules (Regras de leads), Reactions (Reações) e Activity (Atividade), e depois as configurações: Connection (Conexão), Order flow (Fluxo de pedidos), General (Geral) e Sample data (Dados de exemplo). As capturas de tela abaixo mostram os dados de exemplo.

Primeiros passos​

A aba Primeiros passos da sua página inicial adiciona um cartão Set up ClickUp Lead Sync (Configurar o ClickUp Lead Sync) com cinco etapas: 1. Connect ClickUp (Conectar o ClickUp), 2. Your first lead rule (Sua primeira regra de leads), 3. Orders (optional) (Pedidos, opcional), 4. A reaction (optional) (Uma reação, opcional) e 5. Turn it on (Ativar). Cada etapa tem um botão que abre a tela onde fazê-la, e Next (Próximo) avança para a etapa seguinte.

Cartão Set up ClickUp Lead Sync na aba Primeiros passos com as cinco etapas e o botão para abrir a conexão

O cabeçalho do painel​

O cabeçalho mostra On (Ligado) ou Off (Desligado) ao lado do título. O botão de ligar abre Turn ClickUp Lead Sync on (Ativar o ClickUp Lead Sync): ele lista o que está pronto e o que falta (A ClickUp token, um token do ClickUp; A ClickUp workspace, um workspace do ClickUp; A lead rule, uma regra de leads; The order flow (optional), o fluxo de pedidos, opcional; A reaction (optional), uma reação, opcional) e liga o app. Depois de ligado, as regras de leads, o fluxo de pedidos e as reações começam a funcionar.

Gaveta Turn ClickUp Lead Sync on com o token, o workspace e a regra de leads que faltam e o botão Turn on

Hoje​

ClickUp › Today (Hoje) abre com um resumo: quantos leads e pedidos foram enviados hoje ao ClickUp, quantos pedidos foram pagos e quantas reações foram disparadas e quantas mensagens saíram. Abaixo, o estado do app (ligado ou desligado), as etapas de configuração ainda pendentes e os eventos mais recentes, cada um com um rótulo:

  • Task created (Tarefa criada), Task linked (Tarefa vinculada), Comment added (Comentário adicionado): o que o app fez no ClickUp.
  • Order paid (Pedido pago), Reaction (Reação), Message sent (Mensagem enviada): o que aconteceu quando o ClickUp ou um pagamento mudou.
  • Note from ClickUp (Nota do ClickUp), Profile updated from ClickUp (Perfil atualizado pelo ClickUp): comentários e campos que voltaram.
  • Skipped (Ignorado) com o motivo (por exemplo No phone or e-mail, sem telefone nem e-mail, ou 24-hour window closed and no template, janela de 24 horas fechada e sem modelo) e Error (Erro) com o que o ClickUp respondeu e se o app Will try again (Vai tentar de novo) ou Gave up (Desistiu).
Tela Today com os leads e pedidos enviados hoje, o estado desligado, as etapas de configuração e os eventos recentes de tarefas, comentários, notas e erros

Leads​

ClickUp › Leads lista as tarefas de leads que o app conhece: as que ele criou e as que vinculou por telefone ou e-mail. Filtre por Open (Abertas), Closed (Fechadas) ou All (Todas), ou por regra (Every rule, Todas as regras). Cada linha mostra o nome da tarefa, o status dela no ClickUp, o cliente, a lista, a regra, o que a iniciou (por exemplo New conversation, Nova conversa, ou AI assistant, Assistente de IA) e quantos comentários o app adicionou.

Lista de leads com tarefas nos status new lead, contacted e offer sent, seus clientes, lista e regra

O lápis abre o lead: a lista, a regra e o cliente (telefone e e-mail), quando o app o criou e quando o leu pela última vez no ClickUp, e a Activity (Atividade) dele: tarefa criada, comentários adicionados, notas do ClickUp e campos do perfil atualizados pelo ClickUp.

Um lead com a lista, a regra e os dados do cliente e sua atividade: tarefa criada, comentário adicionado, nota do ClickUp e perfil atualizado

Pedidos​

ClickUp › Orders (Pedidos) lista as tarefas de pedidos: Not paid (Não pagos), Paid (Pagos) ou All (Todos). Cada linha mostra o número do pedido, o cliente, o valor e o status da tarefa no ClickUp, e quando foi pago.

Lista de pedidos com pedidos pagos e não pagos, seus valores e status no ClickUp

Regras de leads​

ClickUp › Lead rules (Regras de leads) decide quais conversas viram tarefas no ClickUp. Cada regra ativa cujo gatilho e filtros correspondem a uma conversa cria a sua própria tarefa. Cada linha mostra o gatilho, a lista, os filtros e quantas tarefas, comentários e erros a regra gerou. Use o lápis para editar uma regra, o ícone de ligar para ativá-la ou desativá-la, ou a lixeira para excluí-la. New lead rule (Nova regra de leads) adiciona uma.

Lista de regras de leads com as regras de exemplo New conversations to Sales pipeline e AI assistant leads

O formulário da regra de leads​

A parte de cima do formulário dá nome à regra e define a sua Order (Ordem; o número menor vem primeiro), Active (Ativa) e Whisper only (somente nota interna; nada é gravado no ClickUp: uma nota interna na conversa mostra a tarefa que seria criada).

Formulário da regra de leads com o nome da regra, a ordem, as chaves Active e Whisper only e o gatilho

When (Quando) é o gatilho:

GatilhoQuando uma tarefa é criada
New conversation (also returning customers) (Nova conversa, inclusive clientes que voltam)Uma conversa é aberta.
New customer’s first message (Primeira mensagem de um novo cliente)Alguém escreve para você pela primeira vez.
Tag added (Tag adicionada)Uma tag que você escolhe é adicionada ao cliente.
Profile field filled or equal to a value (Campo do perfil preenchido ou igual a um valor)Um campo do perfil é preenchido, ou recebe o valor que você escolhe.
The AI assistant calls “Send to ClickUp” (O assistente de IA chama “Send to ClickUp”)O seu assistente de IA repassa o lead com a ferramenta Send the lead to the team (ClickUp) (Enviar o lead para a equipe), com um resumo, o interesse e os dados de contato que coletou.
Lead Ads form submitted (Formulário de Lead Ads enviado)Alguém preenche um formulário de Lead Ads do Facebook ou do Instagram.
Only by hand (from the conversation) (Somente manualmente, a partir da conversa)A sua equipe clica em Send as lead (Enviar como lead) no cartão do ClickUp.

Only when (Somente quando) restringe o gatilho:

  • Channels (Canais): vazio significa todos os canais.
  • Source (Origem): Any source (Qualquer origem), Ad click (referral) (Clique em anúncio, referral), Organic (no ad) (Orgânico, sem anúncio) ou Lead Ads form (Formulário de Lead Ads).
  • Keyword in the first message (Palavra-chave na primeira mensagem): várias separadas por vírgulas, basta qualquer uma delas.
  • Only within business hours (Somente em horário comercial): o horário definido em General (Geral).
  • Needs (Exige): Nothing (Nada), A phone number (Um número de telefone), An e-mail address (Um endereço de e-mail) ou A phone number or an e-mail (Um número de telefone ou um e-mail), com Wait for it up to (minutes) (Aguardar até, em minutos). Enquanto isso, o app acompanha as mensagens e o perfil; 0 ignora na hora.
  • Comment instead of a new task within (days) (Comentar em vez de criar uma nova tarefa em até, em dias): quando este cliente tem uma tarefa aberta desta regra criada nos últimos dias, um comentário é adicionado a ela. 0 sempre cria uma nova tarefa.
Seção Only when com canais, origem, palavra-chave, horário comercial, exigência de telefone ou e-mail e comentário em vez de nova tarefa

ClickUp list (Lista do ClickUp) diz para onde vai a tarefa e como ela é preenchida:

  • Space, Folder e List (espaço, pasta e lista).
  • Task name (Nome da tarefa) e Task description (Descrição da tarefa) com marcadores: {name} {firstName} {phone} {email} {channel} {source} {date} {firstMessage} {conversationLink} {agent} {tags} {summary} {interest} {notes} {answers}.
  • Status (vazio: o primeiro status da lista), Priority (Prioridade), Assignee (Responsável: Nobody, ninguém; A fixed ClickUp member, um membro fixo do ClickUp; ou The conversation’s agent (same e-mail in ClickUp), o agente da conversa, com o mesmo e-mail no ClickUp) e Task tags (Tags da tarefa).
Seção ClickUp list com espaço, pasta e lista, modelos de nome e descrição da tarefa, status, prioridade e responsável

Fields (Campos) mapeia valores do MonoChat para campos personalizados do ClickUp. Em cada linha, escolha o MonoChat value (valor do MonoChat: nome, primeiro nome, telefone, e-mail, canal, origem ou anúncio, primeira mensagem, link da conversa, agente atribuído, tags, um CRM profile field ou campo do perfil do CRM, uma Lead form answer ou resposta do formulário de leads, o AI summary ou resumo da IA, AI: interest ou interesse segundo a IA, a data ou Fixed text, texto fixo), o ClickUp field (campo do ClickUp) e a Direction (Direção):

  • MonoChat → ClickUp: o valor é gravado quando a tarefa é criada.
  • Both ways (Nos dois sentidos; nome, telefone, e-mail e campos do perfil do CRM): quando a sua equipe muda o campo no ClickUp, o perfil do cliente no MonoChat é atualizado (uma opção de lista suspensa vira a opção de perfil correspondente, uma data o seu dia, uma caixa de seleção sim ou não); quando muda no MonoChat, a tarefa aberta é atualizada. Um valor que o app acabou de gravar nunca é enviado de volta.

Um valor que não cabe no campo (uma palavra em um campo numérico, uma opção que a lista suspensa não tem) fica vazio e é indicado em Activity (Atividade). Link tasks made in ClickUp by phone / e-mail (Vincular por telefone / e-mail as tarefas criadas no ClickUp) vincula uma tarefa que alguém cria nesta lista ao cliente do MonoChat cujo telefone ou e-mail está no campo mapeado dela, para que as reações também funcionem.

Seção Fields mapeando telefone, e-mail, canal e um campo do perfil do CRM para campos do ClickUp, alguns nos dois sentidos

Reações​

ClickUp › Reactions (Reações) decide o que o MonoChat faz quando algo muda no ClickUp. As reações funcionam nas tarefas que o app conhece: as que ele criou e as que vinculou por telefone ou e-mail. Cada linha mostra a lista, a condição, o que ela faz, Once per task (Uma vez por tarefa) ou toda vez, e quantas vezes foi disparada, enviou uma mensagem ou foi ignorada.

Lista de reações com Order paid para mensagem de agradecimento e Lead won para tag e nota

No formulário da reação:

  • When (Quando): a List (Lista) e depois a Condition (Condição): The status becomes (O status passa a ser) um status que você escolhe, A field condition (Uma condição de campo: uma caixa de seleção é marcada, um campo é preenchido, uma lista suspensa inclui uma opção, um número é maior que 0) ou The order is paid (O pedido é pago). How often (Com que frequência): Once per task (Uma vez por tarefa) ou Every time it becomes true (Toda vez que se tornar verdadeira).
  • Message to the customer (Mensagem ao cliente): Send a message (Enviar uma mensagem) com marcadores {name} {firstName} {task} {status} {orderNo} {amount} {url} {field:Field name}. Ela é enviada como mensagem livre enquanto o canal permitir (WhatsApp, Messenger, Instagram: 24 horas depois da última mensagem do cliente); caso contrário, When the window is closed: WhatsApp template from (Quando a janela estiver fechada: modelo de WhatsApp de) um modelo que você escolhe, ou é ignorada. Clientes com uma tag de descadastro nunca a recebem.
Formulário de reação com a lista Orders, a condição The order is paid, Once per task e a mensagem de agradecimento
  • Also do (Fazer também): Whisper for the team (Nota interna para a equipe), Add tags (Adicionar tags) e Remove tags (Remover tags), Assign the conversation to (Atribuir a conversa a) uma equipe ou uma pessoa, Custom event for your flows (Evento personalizado para os seus fluxos; os seus fluxos com um nó de evento com esta chave são iniciados, com a tarefa nos dados do evento; chave vazia: clickup.paid) e Close the conversation (Encerrar a conversa).
Seção Also do com nota interna, adicionar e remover tags, atribuir a conversa, chave do evento personalizado e encerrar a conversa

Atividade​

ClickUp › Activity (Atividade) guarda 90 dias do que o app fez: All (Tudo), Tasks (Tarefas), Reactions (Reações), Skipped (Ignorados) ou Errors (Erros). Cada evento mostra a tarefa e o cliente, o que aconteceu e por quê, e, nos erros, quantas tentativas foram feitas. Tudo o que falhou pode ser tentado de novo.

Registro de atividade com tarefas criadas, notas e perfis vindos do ClickUp, reações, mensagens enviadas, etapas ignoradas e erros

Conexão​

ClickUp › Connection (Conexão) guarda o ClickUp API token (token de API do ClickUp) e o Workspace. Cole o token, clique em Test (Testar) para listar os seus workspaces, escolha um e clique em Save (Salvar).

Tela Connection com como obter o token, o campo ClickUp API token, o workspace e o botão Test

Fluxo de pedidos​

ClickUp › Order flow (Fluxo de pedidos) transforma pedidos em tarefas em uma lista do ClickUp. Quando um pedido é pago, a tarefa de pedido aberta do cliente é marcada como paga (ou uma tarefa já paga é criada) e as reações de “pago” são executadas. O fluxo de pedidos fica desligado até ter uma lista e uma origem de “pago”.

  • ClickUp list (Lista do ClickUp): espaço, pasta e lista, o nome e a descrição da tarefa, o status de um novo pedido, a prioridade, o responsável, as tags e o mapeamento de campos (valor, moeda, itens, número do pedido, forma de pagamento e referência, endereço e os dados do cliente).
  • When is an order paid? (Quando um pedido está pago?) Uma ou mais destas opções:
    • MonoChat payments (Pagamentos do MonoChat): um pagamento pelos seus links de pagamento do MonoChat marca como pago o pedido aberto do cliente, ou cria um pedido pago.
    • A condition in ClickUp (Uma condição no ClickUp): a sua equipe marca no ClickUp (um status ou um campo); o app percebe na leitura seguinte.
    • Your system (API) (Seu sistema, API): a sua loja ou o seu sistema de pagamento avisa o app. A tela mostra o endereço, uma App key (chave do app) e um comando curl pronto. A chamada precisa de um token de API de usuário do MonoChat e da chave do app, além do telefone, e-mail ou id do cliente e do valor; número do pedido, moeda, itens, forma de pagamento, endereço e referência são opcionais. A mesma referência é registrada uma única vez.
  • When MonoChat or your system says paid, the app marks the task (Quando o MonoChat ou o seu sistema informa que está pago, o app marca a tarefa): define o status e, opcionalmente, marca uma caixa de seleção.

A sua equipe também pode clicar em Create order (Criar pedido) no cartão do ClickUp ao lado de uma conversa: uma tarefa de pedido não pago para esse cliente, marcada como paga quando o pagamento chegar.

Tela Order flow com a lista do ClickUp e as três origens de pagamento: pagamentos do MonoChat, uma condição no ClickUp e o seu sistema (API)

Geral​

ClickUp › General (Geral):

ConfiguraçãoO que faz
Test mode (Modo de teste)Nada é gravado no ClickUp e nada vai para os clientes: cada tarefa, comentário, mensagem e mudança é registrada como uma nota interna na conversa. Desative-o para entrar em produção.
Read ClickUp every (Ler o ClickUp a cada)1, 5 ou 15 minutos. Cada leitura usa uma requisição ao ClickUp por lista (mais quando muitas tarefas mudaram).
Time zone (Fuso horário), Business hours: days (Horário comercial: dias), From (De), To (Até)Para as regras de leads com Only within business hours (Somente em horário comercial).
Language of the team notes (Idioma das notas da equipe)O idioma das notas internas que o app escreve.
Opt-out tags (Tags de descadastro)Clientes com qualquer uma destas tags nunca recebem mensagem do app.
Note in the conversation (Nota na conversa)Uma nota interna para a equipe quando uma tarefa é criada ou comentada, com o link dela.
ClickUp comments → conversation note (Comentários do ClickUp → nota na conversa)Um novo comentário em uma tarefa vinculada (que não tenha sido escrito pelo app) vira uma nota na conversa mais recente do cliente.
Customer notes → ClickUp comment (Notas do cliente → comentário no ClickUp)Uma nota que a sua equipe adiciona a um cliente (o cartão Notas ao lado da conversa) é publicada como comentário na tarefa aberta do cliente, com o nome de quem a escreveu.
Configurações gerais com modo de teste, intervalo de leitura, fuso horário, horário comercial, tags de descadastro e chaves de notas e sincronização de comentários

O cartão do ClickUp ao lado de uma conversa​

Na Caixa de entrada, um cartão ClickUp ao lado da conversa mostra as tarefas do cliente, o status delas e o último comentário do ClickUp, com Open in ClickUp (Abrir no ClickUp). A sua equipe pode usar Send as lead (Enviar como lead; escolha a regra) ou Create order (Criar pedido) com um clique. Enquanto o app está desligado, ou antes de o cliente ter uma tarefa, o cartão informa isso.

Caixa de entrada com o cartão do ClickUp ao lado de uma conversa informando que o ClickUp Lead Sync está desligado e que ainda não existe tarefa

Perguntas frequentes​

O ClickUp atualiza o MonoChat na hora? Não. O ClickUp não consegue chamar o MonoChat, por isso o app lê as listas que usa a cada 1, 5 ou 15 minutos. A conexão com o seu login do ClickUp (OAuth) e as atualizações instantâneas estão planejadas.

O mesmo cliente vai receber muitas tarefas? Não pela mesma regra: dentro dos dias que você definir em Comment instead of a new task within (days) (Comentar em vez de criar uma nova tarefa em até, em dias), o app adiciona um comentário à tarefa aberta do cliente.

O que acontece quando uma mensagem não pode ser enviada? Fora da janela de 24 horas, o app usa o modelo de WhatsApp que você escolheu. Quando não é possível enviar nem uma mensagem livre nem um modelo, ou o cliente tem uma tag de descadastro, a etapa é ignorada e aparece em Activity (Atividade).

Posso testar sem mexer no ClickUp nem nos clientes? Sim. Ative o Test mode (Modo de teste) em General (Geral), ou o Whisper only (somente nota interna) em uma única regra ou reação: tudo é registrado como uma nota interna na conversa.