Atribuir clientes potenciais a um agente de engajamento com um fluxo

Use o Flow Builder para criar seu fluxo e chamar a ação Atribuir meta a SDR de um elemento Ação no fluxo. Crie um fluxo que atribua os clientes potenciais que você deseja a um agente nas condições selecionadas.

Ao chamar a ação invocável, você inclui um ID do agente e uma lista de IDs de registro do cliente potencial que deseja atribuir ao agente. A ação atribui os clientes potenciais e retorna uma lista dos sucessos e falhas da atribuição.

A ação executa estas etapas:

• Confirma que o agente especificado na chamada de ação existe.
• Verifica se os clientes potenciais cumprem os requisitos para atribuição a um agente de Engajamento.
  • A lista não inclui mais de 200 registros de cliente potencial.
  • Os proprietários do registro do cliente potencial têm a permissão Usar agente de engajamento ou Configurar agente de engajamento.
  • Os proprietários do registro têm permissões de email e Inbox.
  • Verifica alvos duplicados na lista e alvos já atribuídos a um agente de Engajamento.
• Atribui os clientes potenciais ao agente, o que inclui adicioná-los ao ritmo de Engajamento de vendas do agente. O agente usa esse ritmo para orquestrar seu esforço de contato por email e respostas a clientes potenciais. A ação atribui esses destinos do ritmo ao agente ou, se o agente tiver Enviar como vendedor ativado, ao proprietário do registro do cliente potencial.

Para usar a ação Atribuir meta ao SDR, você precisa:

• Engajamento do Agentforce ativado.
• O usuário do Salesforce que chama a ação tem uma destas duas permissões:
  • Use o Agente de engajamento, mais a propriedade do lead, contato ou conta pessoal.
  • Configure o Agente de engajamento, além de acesso de leitura ao lead, contato ou conta pessoal.

Referência de ação invocável

• Rótulo: Atribuir meta ao SDR
• Nome da API: assignTargetToSdr
• Categoria: Agentforce SDR
• Descrição: Atribui um registro de lead, contato ou conta pessoal a um agente de Engajamento para alcance por email.
• Suporte para falhas parciais: Sim. Se você atribuir uma lista de metas e qualquer validação de falha, o sistema ainda atribuirá as outras metas ao agente.
• Limite em massa: 200 metas por chamada de ação.

Parâmetros de entrada

• ID de destino (targetId) – Obrigatório. O ID do contato, do lead ou da conta pessoal a atribuir. Os IDs de conta pessoal são convertidos automaticamente para o ID de registro de contato subjacente.
• ID de definição do bot (botDefinitionId) – obrigatório. O ID da definição específica do bot de SDR (agente) à qual atribuir o destino.

Parâmetros de saída

• Erro (errorMessage). O erro retornado quando uma atribuição falha. Esse campo está vazio para cada cliente potencial atribuído com sucesso. No Flow Builder, mapeie esse campo de saída para uma variável para que você possa ramificar seu fluxo caso ocorram falhas. No Apex, verifique o resultado de isSuccess() ou getErrors() padrão da chamada de ação invocável.

Para adicionar a ação invocável a um fluxo:

Limites e melhores práticas

• Inclua até 200 destinos por chamada. Divida listas maiores entre várias invocações.
• Evite falhas garantindo que cada chamada de ação não inclua IDs de destino duplicados.
• Sempre verifique a saída Erro (isSuccess() ou getErrors() no Apex). Como a ação não reverte os erros, alguns registros em uma lista podem ter sucesso enquanto outros falham.