Resumo
Este guia explica como configurar a ação Salesforce - create or update contact no Astra. Esta ação mantém seus dados do Salesforce atualizados, criando ou atualizando automaticamente os registros de contato com base nas conversas com os clientes.
Como esta ação funciona
Quando esta ação é executada:
O Astra procura um Contact no Salesforce usando o e-mail do cliente.
Se o contato existir, ele atualizará os campos mapeados.
Se o contato não existir, ele poderá criar um novo (com base nas suas configurações).
Instruções
Siga estas etapas para configurar a ação do Salesforce:
Etapa 1: Abra o modelo de criação/atualização de contato do Salesforce
Faça login na sua conta Astra.
Vá para a Action Library.
Selecione Salesforce - create or update contact.
Abra a etapa de Configuration.
Etapa 2: Configure a intenção da ação
O que você faz:
Insira um action name e uma intent claros.
Clique em Edit action intent a qualquer momento para atualizá-lo.
O que acontece:
Uma intent clara e detalhada ajuda o agente a decidir quando usar esta ação.
Sincronização offline:
Mantenha isso OFF para executar a ação durante a conversa.
Ligue ON para executar a ação após o término da conversa.
Etapa 3: Selecione sua conta do Salesforce
O que você faz:
Escolha uma conta do Salesforce existente ou clique em Add account para conectar uma nova.
O que acontece:
Todos os dados criados ou atualizados por esta ação serão salvos na conta selecionada.
Etapa 4: Configure a criação e atualização de contatos
Permitir criar e atualizar novos contatos
Quando ON:
Cria um novo contato se um não existir.
Atualiza completamente os contatos que foram originalmente criados através do Astra.
Quando OFF:
Não cria novos contatos.
Permitir a atualização de campos existentes
Quando ON:
Atualiza os campos mapeados para os contatos que já existem no Salesforce, mesmo que não tenham sido criados através do Astra.
Quando OFF:
Não modifica os campos de contato existentes.
Atualiza apenas o campo summary (se configurado).
Etapa 5: Mapear campos (Salesforce → Astra)
O mapeamento de campos define como os dados do Astra são gravados no Salesforce.
O que você faz:
Para cada linha:
Selecione um Salesforce Contact field (lado esquerdo).
Combine-o com um Astra field (lado direito).
O que acontece:
Quando a ação é executada, o Astra envia os dados mapeados para os campos correspondentes no registro de contato do Salesforce.
Campos obrigatórios
Você deve mapear os seguintes campos:
Email
Last name
A ação não será executada sem eles.
Adicionando mais campos
Clique em Map field para adicionar mais mapeamentos.
Você pode mapear:
Campos padrão (Email, Phone, etc.)
Campos personalizados da sua conta do Salesforce
Note: Somente certos tipos de campo são suportados:
String
Email
Phone
Text
Text area
URL
Picklist
Os campos também devem ser habilitados para create e update no Salesforce.
Criando novos campos do Astra
Você pode criar novos campos do Astra durante o mapeamento.
Se você acessar a configuração na página Agent:
Esses campos também podem ser salvos como contact attributes
Os atributos existentes podem aparecer para seleção
Usando o campo summary
Se você mapear um campo do Salesforce para Summary:
O Astra grava um resumo da conversa nesse campo.
Recomenda-se mapeá-lo para um campo personalizado de long text para melhor legibilidade.
Como é o comportamento de ponta a ponta
Veja o que acontece quando a ação é executada:
O Astra procura um Contact usando o e-mail mapeado.
Se nenhum contato existir:
Um novo contato é criado somente se permitido pelas suas configurações.
Se um contato existir:
O contato é atualizado com base na sua configuração.
Se as atualizações completas forem restritas, somente as atualizações relacionadas ao resumo poderão ocorrer.
Recurso adicional: Sincronização offline
A Sincronização offline permite que a ação seja executada após o término da conversa, em vez de durante ela.
Quando habilitado:
A ação é executada uma vez após a conclusão da conversa.
Condições de término da conversa:
Agente de texto: 10 minutos após a última mensagem
Agente de voz: Quando a chamada termina
Isso é útil quando você deseja sincronizar dados finalizados em vez de atualizar os registros em tempo real.
O que fazer em seguida
Uma vez configurada, esta ação:
Capturará automaticamente os detalhes do cliente
Manterá seus contatos do Salesforce atualizados
Reduzirá a entrada manual de dados
Agora você pode incluir esta ação em seus agentes Astra para manter seus dados do Salesforce CRM precisos e atualizados.