View a markdown version of this page

Gerencie leads usando o AWS API de vendas da Central de Parceiros - AWS Central de Parceiros

A referência Central de Parceiros da AWS da API foi reestruturada. Para obter mais informações sobre as operações de API suportadas, consulte a Referência Central de Parceiros da AWS da API.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Gerencie leads usando o AWS API de vendas da Central de Parceiros

O que é um lead?

Nas vendas entre empresas (B2B), um lead representa um cliente em potencial que expressou interesse nos produtos ou serviços de uma empresa, mas ainda não foi totalmente qualificado como uma oportunidade de vendas. Os leads são o estágio inicial do funil de vendas e exigem nutrição e qualificação antes de serem convertidos em oportunidades de venda conjunta ativa com. AWS

Os leads compartilhados AWS com os parceiros são baseados em sinais de engajamento do cliente, como participação em webinars, participação em campanhas ou consultas sobre soluções de parceiros. Esses leads incluem um contexto valioso, como informações sobre a empresa do cliente, problemas comerciais e detalhes do engajamento, para ajudar os parceiros a priorizar e qualificar oportunidades em potencial.

Trabalhando com convites para leads

Os parceiros recebem convites de leads AWS quando clientes em potencial expressam interesse em soluções ou serviços de parceiros. O processo de convite de leads permite que os parceiros avaliem os leads antes de se comprometerem com o engajamento, garantindo uma alocação eficiente de recursos e maiores taxas de conversão.

Recebendo convites para leads

AWS cria convites para leads e os compartilha com parceiros por meio da API de vendas. Quando um novo convite de lead estiver disponível, AWS envie um convite de engajamento com o contexto do lead para os parceiros qualificados.

Os parceiros devem monitorar o Engagement Invitation Created evento usando a Amazon EventBridge. Essa notificação de evento inclui o payloadType campo definido comoLeadInvitation, permitindo que os parceiros diferenciem os convites para leads dos convites para oportunidades. Ao receber o evento, os parceiros podem recuperar os detalhes do convite para avaliar o lead.

Listando convites para leads

Os parceiros podem ver todos os seus convites de leads usando a ação da ListEngagementInvitations API. Essa ação recupera convites em que o responsável pela chamada é remetente ou destinatário.

Para filtrar especificamente os convites de leads, os parceiros devem usar o payloadType filtro com o valor. LeadInvitation Esse filtro garante que somente os convites de leads sejam retornados, excluindo os convites de oportunidade dos resultados.

Os convites para leads podem estar nos seguintes estados:

  • Pendente: aguardando aceitação ou rejeição do parceiro

  • Aceito: o parceiro aceitou o convite e obteve acesso aos detalhes completos do lead

  • Rejeitado: o parceiro recusou o convite

  • Expirado: o convite expirou sua data de validade sem ação

Avaliação de convites de leads

Antes de aceitar um convite de lead, os parceiros devem recuperar informações detalhadas do convite usando a ação da GetEngagementInvitation API. Isso fornece um contexto essencial para tomar decisões informadas de aceitação ou rejeição.

A carga útil do convite principal inclui:

Informações do cliente (disponíveis na pré-aceitação):

  • Nome da empresa, setor e país

  • URL do site

  • Segmento de mercado (corporativo, grande, médio, pequeno, micro)

  • AWS nível de maturidade (Avaliação, Single-Account, Multi-Account)

Interações com o cliente:

  • Tipo de fonte e informações da campanha

  • Ação tomada pelo cliente (preenchimento do formulário, participação no webinar etc.)

  • Descrição do problema comercial fornecida pelo cliente

  • Categoria de caso de uso

  • Título do contato (fornece o contexto da Autoridade para a qualificação do BANT)

Importante

As informações de contato do cliente (nome, e-mail, número de telefone) não estão visíveis na fase de convite. Os detalhes de contato ficam disponíveis somente após a aceitação do convite, garantindo a privacidade do cliente e evitando o comportamento de cultivo de chumbo.

Aceitando convites de leads

Quando um parceiro decide buscar um lead, ele deve aceitar o convite usando a ação da AcceptEngagementInvitation API. Essa ação adiciona o parceiro ao contrato e concede acesso aos detalhes completos do lead, incluindo informações de contato do cliente.

Após a aceitação:

  • O parceiro é adicionado como membro do contrato

  • As informações de contato do cliente se tornam visíveis por meio do contexto do lead de engajamento

  • O lead é classificado como Partner Qualified Lead (PQL) em sistemas AWS

  • O lead aparece na lista de leads ativos do parceiro

  • Os parceiros podem começar a cultivar o lead e estabelecer contato com o cliente

Os parceiros podem aceitar vários convites de leads de forma programática ligando AcceptEngagementInvitation para cada convite, permitindo o processamento eficiente em massa de leads de alta qualidade.

Rejeitando convites para leads

Se um lead não se alinhar às capacidades, à capacidade ou ao foco comercial do parceiro, os parceiros podem recusar o convite usando a ação da RejectEngagementInvitation API. Ao rejeitar um convite de lead, os parceiros devem fornecer um motivo de rejeição para ajudar a AWS melhorar o encaminhamento e a correspondência de leads. Os motivos comuns de rejeição incluem:

  • Falta de cobertura geográfica

  • Conhecimento técnico insuficiente para o caso de uso

  • Restrições de capacidade atuais

  • Incompatibilidade entre clientes e setores

  • Desalinhamento orçamentário

Após a rejeição:

  • O lead é removido da fila de convites pendentes do parceiro

  • As informações de contato do cliente nunca são compartilhadas com o parceiro

  • O lead é classificado como um lead rejeitado por parceiro (PRL) nos sistemas AWS

  • O convite permanece visível na lista de convites rejeitados do parceiro para referência

Os leads rejeitados podem ser elegíveis para serem transferidos para outros parceiros, desde que os requisitos de consentimento do cliente sejam atendidos.

Gerenciando leads aceitos

Depois de aceitar um convite de lead, os parceiros podem acessar informações completas do lead, cultivar relacionamentos com os clientes e acompanhar o lead nas etapas de qualificação.

Visualizando detalhes do lead

Os parceiros acessam todos os detalhes do lead usando a ação GetEngagement da API. O contrato contém um contexto de lead com informações abrangentes sobre o cliente e suas interações com ele AWS.

O contexto do Lead inclui:

Perfil completo do cliente:

  • Todas as informações da empresa contidas no convite original

  • Detalhes de contato completos para todas as interações com o cliente (nome, e-mail, telefone, cargo comercial)

  • AWS nível de maturidade e segmento de mercado

Histórico de interação:

  • Vários pontos de contato com o cliente consolidados em um único contrato

  • Cada interação inclui informações de origem, ação do cliente, problema comercial e detalhes de contato

  • As interações são listadas cronologicamente para fornecer uma visão completa da jornada do cliente

Status de qualificação:

  • Estado atual da qualificação do lead (status não qualificado, qualificado, desqualificado ou personalizado)

  • Os parceiros podem atualizar esse status à medida que avançam no processo de qualificação

Essa visão abrangente permite que os parceiros entendam o histórico completo de engajamento do cliente em várias AWS campanhas e pontos de contato, em vez de tratar cada interação como um lead separado.

Listando leads ativos

Os parceiros podem recuperar todos os seus leads ativos usando a ação da ListEngagements API com o contextType filtro definido como. Lead Isso retorna compromissos em que o parceiro é membro e o engajamento contém um contexto de lead.

A resposta da lista inclui informações importantes, como:

  • ID e título do engajamento

  • Nome da empresa do cliente

  • Pontuação atual de engajamento

  • Status de qualificação

  • Número de interações

  • Carimbos de data e hora de criação e modificação

Os parceiros podem usar essa lista para criar painéis, monitorar a integridade do funil de leads e identificar leads que precisam de atenção.

Enriquecendo leads com insights de prospecção

Os parceiros podem enriquecer os leads aceitos com AWS insights para melhor priorizá-los e qualificá-los antes de investir em divulgação. O enriquecimento é realizado de forma assíncrona por meio de tarefas de prospecção, que aumentam o engajamento do lead com sinais derivados para apoiar as decisões AWS de qualificação.

Iniciando uma tarefa de prospecção

Os parceiros iniciam o enriquecimento usando a ação da StartProspectingFromEngagementTask API. Essa ação aceita até 100 identificadores de engajamento em uma única solicitação, permitindo que os parceiros enriqueçam leads em lotes. A tarefa é executada de forma assíncrona e retorna imediatamente um TaskId e TaskArn que os parceiros usam para acompanhar o progresso. A inicial TaskStatus é uma de PENDINGIN_PROGRESS,COMPLETED, ouFAILED.

Opcionalmente, os parceiros podem fornecer um TaskName para rotular a tarefa e um ClientToken para garantir a idempotência nas novas tentativas.

Pesquisa de resultados

Como a prospecção é assíncrona, os parceiros pesquisam para serem concluídas usando a ação da GetProspectingFromEngagementTask API, com o retornado no início. TaskId A resposta relata o status geral da tarefa e um resultado por engajamento para cada identificador enviado.

Cada compromisso é processado de forma independente, para que os compromissos individuais possam ter sucesso ou falhar sem afetar os outros na mesma tarefa. Para cada contrato, o resultado inclui:

  • Identificador de engajamento: o engajamento que foi processado.

  • Status:PENDING,IN_PROGRESS,COMPLETED, ouFAILED.

  • Identificador de contexto de prospecção: preenchido quando o engajamento é processado com sucesso. Esse identificador faz referência ao contexto de prospecção enriquecido adicionado ao contrato e pode ser usado em operações subsequentes.

  • Código e mensagem do motivo: preenchidos somente quando um contrato falha, fornecendo um código de falha enumerado e uma descrição legível por humanos com etapas de recuperação sugeridas.

Monitoramento de várias tarefas

Para rastrear o enriquecimento de muitos leads, os parceiros usam a ação da ListProspectingFromEngagementTasks API. Essa ação lista todas as tarefas de prospecção iniciadas pela conta do chamador e oferece suporte a filtros opcionais por identificador de tarefa, nome da tarefa ou intervalo de tempo de início, com classificação configurável. A resposta é paginada; use o NextToken valor de cada resposta para recuperar as páginas subsequentes.

Quando o enriquecimento é concluído com sucesso, os AWS insights são adicionados ao engajamento como um contexto de prospecção. Os parceiros podem recuperar os detalhes enriquecidos GetEngagement e usá-los para definir o status de qualificação do lead e decidir quais leads avançarão em direção à conversão.

Atualizando as informações do lead

À medida que os parceiros cultivam leads e coletam informações adicionais, eles podem atualizar os detalhes dos leads usando a ação da UpdateEngagementContext API. Essa ação permite que os parceiros modifiquem o contexto do lead dentro do contrato.

Os parceiros podem atualizar:

Status de qualificação: os parceiros devem atualizar o status de qualificação à medida que avançam em seu processo interno de qualificação:

  • Não qualificado: status padrão após aceitar um lead; indica que o lead precisa ser avaliado

  • Qualificado: o lead atende aos critérios de qualificação e mostra alto potencial de conversão em uma oportunidade

  • Desqualificado: o lead não atende aos critérios ou não é adequado para as soluções do parceiro

  • Estados personalizados: os parceiros podem definir seus próprios estados de qualificação para corresponder aos seus processos internos

Metadados de leads: os parceiros podem adicionar ou atualizar informações adicionais relevantes para seus processos de qualificação e desenvolvimento.

A atualização do status de qualificação ajuda os parceiros a acompanhar a progressão dos leads, gerar relatórios de funil precisos e identificar leads prontos para serem convertidos em oportunidades.

Monitoramento AWS Atualizações

AWS pode atualizar as informações do lead com base em novos sinais de engajamento do cliente ou em uma pontuação de engajamento refinada. Quando o contrato é AWS atualizado, os parceiros recebem um Engagement Updated evento via Amazon EventBridge.

Essas atualizações podem incluir:

  • Pontuações de engajamento refinadas com base na atividade de novos clientes

  • Interações adicionais com o cliente a partir de novas campanhas ou pontos de contato

  • Informações atualizadas do cliente

Os parceiros devem monitorar esses eventos e ligar GetEngagement para obter os detalhes mais recentes do lead. Isso garante que os parceiros tenham as informações mais atuais para priorizar e estimular leads.

O Engagement Updated evento inclui o contextTypes campo, permitindo que os parceiros filtrem especificamente os leads (interações com o contexto do lead).

Convertendo um lead em uma oportunidade

Quando um lead é qualificado e demonstra uma intenção séria de compra, os parceiros podem convertê-lo em uma oportunidade de colaboração formal com a. AWS Essa conversão marca a transição da criação de leads (principalmente orientada por parceiros) para a gestão de oportunidades (colaborativa com). AWS

Os parceiros podem agilizar o processo de criação e vinculação de oportunidades usando a ação de API de StartOpportunityFromEngagementTask conveniência. Essa API de tarefas orquestra várias ações automaticamente:

  1. Cria um rascunho de oportunidade com informações preliminares do contexto do lead

  2. Vincula a oportunidade ao engajamento na fonte por meio de um instantâneo de recursos

  3. Adiciona o CustomerProject contexto ao engajamento

Esse método de conveniência reduz o número de chamadas de API necessárias e garante o rastreamento adequado da atribuição. Os parceiros que usam essa abordagem ainda precisam:

  • Complete os detalhes da oportunidade usando UpdateOpportunity

  • Soluções de parceiros associados usando AssociateOpportunity

  • Envie a oportunidade usando StartEngagementFromOpportunityTask quando estiver pronta

A API de conveniência é particularmente útil para parceiros com fluxos de trabalho automatizados de leads para oportunidades que desejam minimizar a complexidade da integração.

Abordagem alternativa: Step-by-step API

Criando um rascunho de oportunidade

A primeira etapa para converter um lead é criar um rascunho de oportunidade usando a ação da CreateOpportunity API. Isso cria uma oportunidade com o Lifecycle.ReviewStatus conjunto dePending Submission. Nesse estágio, a oportunidade ainda não foi enviada AWS para validação.

Os parceiros devem preencher a oportunidade com informações coletadas durante a criação de leads, incluindo:

  • Detalhes da conta do cliente

  • Informações do projeto e problema de negócios

  • Gasto esperado do cliente

  • Data de fechamento da meta

  • Quaisquer outros detalhes relevantes coletados durante a qualificação

A oportunidade de rascunho permite que os parceiros preparem informações completas antes de enviá-las AWS, garantindo maiores taxas de aprovação e uma validação mais rápida.

Vinculando oportunidades para liderar o engajamento

Depois de criar o rascunho da oportunidade, os parceiros devem vinculá-lo ao engajamento do lead de origem usando a ação da CreateResourceSnapshot API. Essa etapa é fundamental para:

  • Rastreamento de atribuição: estabelece a cadeia de proveniência desde o convite do lead até o fechamento da oportunidade, permitindo o cálculo preciso do ROI para campanhas de marketing e fontes de leads.

  • Métricas de conversão: permite que AWS os parceiros avaliem as taxas de conversão de leads em oportunidades e identifiquem fontes de leads bem-sucedidas.

  • Preservação do contexto: mantém o histórico completo da jornada do cliente, incluindo todas as interações originais e sinais de engajamento.

Ao criar o instantâneo do recurso, os parceiros especificam:

  • O ID do engajamento (engajamento do lead de origem)

  • O identificador de oportunidade

  • O tipo de recurso (Oportunidade)

Essa ação adiciona automaticamente um CustomerProject contexto ao engajamento, sinalizando que o lead foi convertido em uma oportunidade ativa. O engajamento agora contém o contexto original do lead (preservando o histórico) e o novo CustomerProject contexto (indicando uma oportunidade ativa).

Preenchendo os detalhes da oportunidade

Depois que a oportunidade for criada e vinculada, os parceiros devem preencher os requisitos adicionais da oportunidade antes da submissão. Consulte a ação AssociateOpportunity da API para obter detalhes.

Atualização dos detalhes do projeto: os parceiros podem usar a ação da UpdateOpportunity API para refinar as informações do projeto, os problemas comerciais do cliente, os gastos esperados e outros detalhes relevantes coletados durante a qualificação do lead.

Enviando a oportunidade

Depois que todas as informações necessárias forem preenchidas, os parceiros enviarão a oportunidade de AWS validação usando a API de StartEngagementFromOpportunityTask conveniência. Isso transfere a oportunidade do status de rascunho para o processo de AWS revisão.

Requisito de validação: O contrato deve ter um CustomerProject contexto antes do envio. Esse contexto é criado automaticamente quando usado CreateResourceSnapshot para vincular a oportunidade ao engajamento. Se esse contexto estiver ausente, o envio falhará.

Após o envio:

  • As Lifecycle.ReviewStatus mudanças da oportunidade em Submitted

  • O lead é classificado como Partner Sales Qualified Lead (PSQL) em sistemas AWS

  • AWS inicia a validação para garantir que os detalhes da oportunidade sejam precisos e completos

  • Nenhuma alteração pode ser feita na oportunidade até que o processo de análise seja concluído

A oportunidade então segue o fluxo de trabalho de validação padrão descrito na documentação “Trabalhando com suas oportunidades”, progredindo por estados como Ação In-Review Obrigatória, Aprovada ou Desqualificada.