Conecta-seEntrar na plataforma

Buscar dados do CRM

Trazer para o fluxo a etapa, o valor, o responsável e campos do negócio e do contato.

Lógica e processamentoVendas e CRMConexão: CRM do workspace ligado

O que faz

Traz para o fluxo a etapa, o valor, o responsável e campos do negócio e do contato, para usar nas mensagens. Campos sensíveis nunca saem.

Quando usar: Use para trazer dados do CRM para dentro da conversa, como a etapa do negócio, o valor ou o responsável, e usar nas mensagens do fluxo.

Exemplo de situação: O cliente pergunta como anda o pedido. O fluxo busca o negócio aberto e responde com a etapa atual e o nome do vendedor responsável.

Campos marcados como sensíveis no CRM nunca vêm para o fluxo, nem se forem escolhidos. Textos longos chegam cortados em 500 caracteres.

Antes de começar

Conexão necessária: CRM do workspace ligado.

Adicione **Buscar dados do CRM** e escolha os campos extras que o fluxo precisa.

Passo a passo

  1. Ligue o CRM do workspace em Vendas. Com o CRM desligado, a seção CRM some da aba Blocos e os blocos que já estão no fluxo seguem sem fazer nada, com o motivo no registro do fluxo.
  2. Adicione Buscar dados do CRM e escolha os campos extras que o fluxo precisa.
  3. Use os dados nas mensagens seguintes, como <fluxo.crm.negocio.etapa> e <fluxo.crm.negocio.responsavel>.
  4. Ligue a saída Sem negócio a um caminho para quem ainda não tem negócio aberto.

Campos

  • Campos extras

    Campos personalizados que também vêm para o fluxo. Etapa, funil, valor e responsável vêm sempre.

    Exemplo:
    (escolha na lista do campo)

  • Guardar em

    Variável do fluxo com os dados, por exemplo <fluxo.crm.negocio.etapa>.

    Padrão:
    crm

  • Negócio (variável)

    Em campos adicionais

    Vazio usa o negócio guardado pelo Criar ou atualizar negócio ou, sem ele, o negócio aberto do contato desta conversa.

    Exemplo:
    <fluxo.negocioId>

Saídas

Caminhos do bloco

  • PróximoOs dados do negócio e do contato estão em <fluxo.crm>.
  • Sem negócioO contato não tem negócio aberto; os campos de contato escolhidos ainda vêm em <fluxo.crm.contato>.
  • ErroO CRM está desligado, o negócio não existe neste workspace ou o CRM recusou a ação. Sem esta saída ligada, o bloco anota o motivo no registro e segue pela saída padrão.

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <buscardadosdocrm.origem>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<buscardadosdocrm.origem>jsonOrigem e referências de anúncios registradas, sem inventar campanha ou atribuir pagamento. Use origem.attribution.adId e origem.attribution.campaignId quando disponíveis.
<buscardadosdocrm.negocio>jsonDados do negócio: numero, titulo, funil, etapa, valor, temperatura, responsavel e campos.
<buscardadosdocrm.contato>jsonCampos escolhidos do contato.

Exemplo de uso

Objetivo: Responder em que etapa está o negócio do cliente.

InícioBuscar dados do CRMTexto: Seu pedido está em <fluxo.crm.negocio.etapa>
Guardar em
crm

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O registro do fluxo mostra “O CRM está desligado neste workspace”
Ligue o CRM em Vendas. Enquanto ele estiver desligado, o bloco vai para a saída Erro, se estiver ligada, ou segue pela saída padrão sem gravar nada.
Um campo escolhido não aparece
Confira se ele não está marcado como sensível no CRM e se vale para o funil do negócio. Campos sensíveis nunca saem do CRM.
O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.

Blocos relacionados