Começando
Funcionalidades
Documentação de Integração
- Integração com Asana
- Integração com Box
- Integração com ClickUp
- Integração com GitHub
- Integração com Gmail
- Integração com Google Calendar
- Integração com Google Sheets
- Integração com HubSpot
- Integração com Jira
- Integração com o Linear
- Integração com o Notion
- Integração com Salesforce
- Integração com Shopify
- Integração com Slack
- Integração Stripe
- Integração com Zendesk
Guias
Recursos
Integração com Salesforce
Automação de vendas e CRM com integração Salesforce para CrewAI.
Visão Geral
Permita que seus agentes gerenciem relacionamentos com clientes, processos de vendas e dados através do Salesforce. Crie e atualize registros, gerencie leads e oportunidades, execute consultas SOQL e otimize seus fluxos de trabalho de CRM com automação potencializada por IA.
Pré-requisitos
Antes de usar a integração Salesforce, certifique-se de que você possui:
- Uma conta CrewAI Enterprise com assinatura ativa
- Uma conta Salesforce com permissões apropriadas
- Sua conta Salesforce conectada via a página de Integrações
Ferramentas Disponíveis
Gerenciamento de Registros
Descrição: Crie um novo registro de Contato no Salesforce.
Parâmetros:
FirstName
(string, opcional): Primeiro nomeLastName
(string, obrigatório): Sobrenome - Este campo é obrigatórioaccountId
(string, opcional): ID da Conta - Conta à qual o contato pertenceEmail
(string, opcional): Endereço de e-mailTitle
(string, opcional): Cargo do contato, como CEO ou Vice-presidenteDescription
(string, opcional): Descrição do contatoadditionalFields
(object, opcional): Campos adicionais no formato JSON para campos personalizados de Contato
Descrição: Crie um novo registro de Lead no Salesforce.
Parâmetros:
FirstName
(string, opcional): Primeiro nomeLastName
(string, obrigatório): Sobrenome - Este campo é obrigatórioCompany
(string, obrigatório): Empresa - Este campo é obrigatórioEmail
(string, opcional): Endereço de e-mailPhone
(string, opcional): Número de telefoneWebsite
(string, opcional): URL do siteTitle
(string, opcional): Cargo do contato, como CEO ou Vice-presidenteStatus
(string, opcional): Status do Lead - Use as Configurações de Workflow do Connect Portal para selecionar o status do LeadDescription
(string, opcional): Descrição do leadadditionalFields
(object, opcional): Campos adicionais no formato JSON para campos personalizados de Lead
Descrição: Crie um novo registro de Oportunidade no Salesforce.
Parâmetros:
Name
(string, obrigatório): Nome da Oportunidade - Este campo é obrigatórioStageName
(string, opcional): Estágio da Oportunidade - Use as Configurações de Workflow do Connect Portal para selecionar o estágioCloseDate
(string, opcional): Data de fechamento no formato YYYY-MM-DD - Padrão para 30 dias a partir da data atualAccountId
(string, opcional): Conta à qual a Oportunidade pertenceAmount
(string, opcional): Valor total estimado da vendaDescription
(string, opcional): Descrição da oportunidadeOwnerId
(string, opcional): Usuário Salesforce designado para esta OportunidadeNextStep
(string, opcional): Descrição da próxima tarefa no fechamento da OportunidadeadditionalFields
(object, opcional): Campos adicionais no formato JSON para campos personalizados de Oportunidade
Descrição: Crie um novo registro de Tarefa no Salesforce.
Parâmetros:
whatId
(string, opcional): Relacionado ao ID - ID da Conta ou Oportunidade relacionada à TarefawhoId
(string, opcional): ID do Nome - ID do Contato ou Lead relacionado à Tarefasubject
(string, obrigatório): Assunto da tarefaactivityDate
(string, opcional): Data da Atividade no formato YYYY-MM-DDdescription
(string, opcional): Descrição da tarefataskSubtype
(string, obrigatório): Subtipo da Tarefa - Opções: task, email, listEmail, callStatus
(string, opcional): Status - Opções: Not Started, In Progress, CompletedownerId
(string, opcional): ID do responsável - Usuário Salesforce designado para a TarefacallDurationInSeconds
(string, opcional): Duração da chamada em segundosisReminderSet
(boolean, opcional): Se o lembrete está definidoreminderDateTime
(string, opcional): Data/Hora do lembrete no formato ISOadditionalFields
(object, opcional): Campos adicionais no formato JSON para campos personalizados de Tarefa
Descrição: Crie um novo registro de Conta no Salesforce.
Parâmetros:
Name
(string, obrigatório): Nome da Conta - Este campo é obrigatórioOwnerId
(string, opcional): Usuário Salesforce responsável por esta ContaWebsite
(string, opcional): URL do sitePhone
(string, opcional): Número de telefoneDescription
(string, opcional): Descrição da contaadditionalFields
(object, opcional): Campos adicionais no formato JSON para campos personalizados de Conta
Descrição: Crie um registro de qualquer tipo de objeto no Salesforce.
Nota: Esta é uma ferramenta flexível para criar registros de tipos de objetos personalizados ou desconhecidos.
Atualização de Registros
Descrição: Atualize um registro de Contato existente no Salesforce.
Parâmetros:
recordId
(string, obrigatório): ID do registro a ser atualizadoFirstName
(string, opcional): Primeiro nomeLastName
(string, opcional): SobrenomeaccountId
(string, opcional): ID da Conta à qual o contato pertenceEmail
(string, opcional): Endereço de e-mailTitle
(string, opcional): Cargo do contatoDescription
(string, opcional): Descrição do contatoadditionalFields
(object, opcional): Campos adicionais no formato JSON para campos personalizados de Contato
Descrição: Atualize um registro de Lead existente no Salesforce.
Parâmetros:
recordId
(string, obrigatório): ID do registro a ser atualizadoFirstName
(string, opcional): Primeiro nomeLastName
(string, opcional): SobrenomeCompany
(string, opcional): Nome da empresaEmail
(string, opcional): Endereço de e-mailPhone
(string, opcional): Número de telefoneWebsite
(string, opcional): URL do siteTitle
(string, opcional): Cargo do contatoStatus
(string, opcional): Status do LeadDescription
(string, opcional): Descrição do leadadditionalFields
(object, opcional): Campos adicionais no formato JSON para campos personalizados de Lead
Descrição: Atualize um registro de Oportunidade existente no Salesforce.
Parâmetros:
recordId
(string, obrigatório): ID do registro a ser atualizadoName
(string, opcional): Nome da OportunidadeStageName
(string, opcional): Estágio da oportunidadeCloseDate
(string, opcional): Data de fechamento no formato YYYY-MM-DDAccountId
(string, opcional): Conta à qual a Oportunidade pertenceAmount
(string, opcional): Valor total estimado da vendaDescription
(string, opcional): Descrição da oportunidadeOwnerId
(string, opcional): Usuário Salesforce responsável por esta OportunidadeNextStep
(string, opcional): Descrição da próxima tarefa no fechamento da OportunidadeadditionalFields
(object, opcional): Campos adicionais no formato JSON para campos personalizados de Oportunidade
Descrição: Atualize um registro de Tarefa existente no Salesforce.
Parâmetros:
recordId
(string, obrigatório): ID do registro a ser atualizadowhatId
(string, opcional): Relacionado ao ID - ID da Conta ou Oportunidade relacionadawhoId
(string, opcional): ID do Nome - ID do Contato ou Lead relacionado à Tarefasubject
(string, opcional): Assunto da tarefaactivityDate
(string, opcional): Data da Atividade no formato YYYY-MM-DDdescription
(string, opcional): Descrição da tarefaStatus
(string, opcional): Status - Opções: Not Started, In Progress, CompletedownerId
(string, opcional): ID do responsável - Usuário Salesforce designado para a TarefacallDurationInSeconds
(string, opcional): Duração da chamada em segundosisReminderSet
(boolean, opcional): Se o lembrete está definidoreminderDateTime
(string, opcional): Data/Hora do lembrete em formato ISOadditionalFields
(object, opcional): Campos adicionais no formato JSON para campos personalizados de Tarefa
Descrição: Atualize um registro de Conta existente no Salesforce.
Parâmetros:
recordId
(string, obrigatório): ID do registro a ser atualizadoName
(string, opcional): Nome da ContaOwnerId
(string, opcional): Usuário Salesforce responsável por esta ContaWebsite
(string, opcional): URL do sitePhone
(string, opcional): Número de telefoneDescription
(string, opcional): Descrição da contaadditionalFields
(object, opcional): Campos adicionais no formato JSON para campos personalizados de Conta
Descrição: Atualize um registro de qualquer tipo de objeto no Salesforce.
Nota: Esta é uma ferramenta flexível para atualizar registros de tipos de objetos personalizados ou desconhecidos.
Recuperação de Registros
Descrição: Obtenha um registro de Contato pelo seu ID.
Parâmetros:
recordId
(string, obrigatório): ID do registro do Contato
Descrição: Obtenha um registro de Lead pelo seu ID.
Parâmetros:
recordId
(string, obrigatório): ID do registro do Lead
Descrição: Obtenha um registro de Oportunidade pelo seu ID.
Parâmetros:
recordId
(string, obrigatório): ID do registro da Oportunidade
Descrição: Obtenha um registro de Tarefa pelo seu ID.
Parâmetros:
recordId
(string, obrigatório): ID do registro da Tarefa
Descrição: Obtenha um registro de Conta pelo seu ID.
Parâmetros:
recordId
(string, obrigatório): ID do registro da Conta
Descrição: Obtenha um registro de qualquer tipo de objeto pelo seu ID.
Parâmetros:
recordType
(string, obrigatório): Tipo do registro (ex.: “CustomObject__c”)recordId
(string, obrigatório): ID do registro
Busca de Registros
Descrição: Pesquise registros de Contato com filtragem avançada.
Parâmetros:
filterFormula
(object, opcional): Filtro avançado em forma normal disjuntiva com operadores específicos de camposortBy
(string, opcional): Campo para ordenação (ex.: “CreatedDate”)sortDirection
(string, opcional): Direção da ordenação - Opções: ASC, DESCincludeAllFields
(boolean, opcional): Incluir todos os campos nos resultadospaginationParameters
(object, opcional): Configurações de paginação com pageCursor
Descrição: Pesquise registros de Lead com filtragem avançada.
Parâmetros:
filterFormula
(object, opcional): Filtro avançado em forma normal disjuntiva com operadores específicos de camposortBy
(string, opcional): Campo para ordenação (ex.: “CreatedDate”)sortDirection
(string, opcional): Direção da ordenação - Opções: ASC, DESCincludeAllFields
(boolean, opcional): Incluir todos os campos nos resultadospaginationParameters
(object, opcional): Configurações de paginação com pageCursor
Descrição: Pesquise registros de Oportunidade com filtragem avançada.
Parâmetros:
filterFormula
(object, opcional): Filtro avançado em forma normal disjuntiva com operadores específicos de camposortBy
(string, opcional): Campo para ordenação (ex.: “CreatedDate”)sortDirection
(string, opcional): Direção da ordenação - Opções: ASC, DESCincludeAllFields
(boolean, opcional): Incluir todos os campos nos resultadospaginationParameters
(object, opcional): Configurações de paginação com pageCursor
Descrição: Pesquise registros de Tarefa com filtragem avançada.
Parâmetros:
filterFormula
(object, opcional): Filtro avançado em forma normal disjuntiva com operadores específicos de camposortBy
(string, opcional): Campo para ordenação (ex.: “CreatedDate”)sortDirection
(string, opcional): Direção da ordenação - Opções: ASC, DESCincludeAllFields
(boolean, opcional): Incluir todos os campos nos resultadospaginationParameters
(object, opcional): Configurações de paginação com pageCursor
Descrição: Pesquise registros de Conta com filtragem avançada.
Parâmetros:
filterFormula
(object, opcional): Filtro avançado em forma normal disjuntiva com operadores específicos de camposortBy
(string, opcional): Campo para ordenação (ex.: “CreatedDate”)sortDirection
(string, opcional): Direção da ordenação - Opções: ASC, DESCincludeAllFields
(boolean, opcional): Incluir todos os campos nos resultadospaginationParameters
(object, opcional): Configurações de paginação com pageCursor
Descrição: Pesquise registros de qualquer tipo de objeto.
Parâmetros:
recordType
(string, obrigatório): Tipo de registro para buscarfilterFormula
(string, opcional): Critérios de busca por filtroincludeAllFields
(boolean, opcional): Incluir todos os campos nos resultadospaginationParameters
(object, opcional): Configurações de paginação com pageCursor
Recuperação por List View
Descrição: Obtenha registros de Contato de um List View específico.
Parâmetros:
listViewId
(string, obrigatório): ID do List ViewpaginationParameters
(object, opcional): Configurações de paginação com pageCursor
Descrição: Obtenha registros de Lead de um List View específico.
Parâmetros:
listViewId
(string, obrigatório): ID do List ViewpaginationParameters
(object, opcional): Configurações de paginação com pageCursor
Descrição: Obtenha registros de Oportunidade de um List View específico.
Parâmetros:
listViewId
(string, obrigatório): ID do List ViewpaginationParameters
(object, opcional): Configurações de paginação com pageCursor
Descrição: Obtenha registros de Tarefa de um List View específico.
Parâmetros:
listViewId
(string, obrigatório): ID do List ViewpaginationParameters
(object, opcional): Configurações de paginação com pageCursor
Descrição: Obtenha registros de Conta de um List View específico.
Parâmetros:
listViewId
(string, obrigatório): ID do List ViewpaginationParameters
(object, opcional): Configurações de paginação com pageCursor
Descrição: Obtenha registros de qualquer tipo de objeto a partir de um List View específico.
Parâmetros:
recordType
(string, obrigatório): Tipo do registrolistViewId
(string, obrigatório): ID do List ViewpaginationParameters
(object, opcional): Configurações de paginação com pageCursor
Campos Personalizados
Descrição: Crie campos personalizados para objetos de Contato.
Parâmetros:
label
(string, obrigatório): Rótulo do campo para exibições e referência internatype
(string, obrigatório): Tipo do campo - Opções: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, LongTextArea, Html, Time, UrldefaultCheckboxValue
(boolean, opcional): Valor padrão para campos checkboxlength
(string, obrigatório): Comprimento para campos numéricos/textodecimalPlace
(string, obrigatório): Casas decimais para campos numéricospickListValues
(string, obrigatório): Valores para campos picklist (separados por novas linhas)visibleLines
(string, obrigatório): Linhas visíveis para campos multiseleção/área de textodescription
(string, opcional): Descrição do campohelperText
(string, opcional): Texto de ajuda exibido ao passar o mousedefaultFieldValue
(string, opcional): Valor padrão do campo
Descrição: Crie campos personalizados para objetos de Lead.
Parâmetros:
label
(string, obrigatório): Rótulo do campo para exibições e referência internatype
(string, obrigatório): Tipo do campo - Opções: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, LongTextArea, Html, Time, UrldefaultCheckboxValue
(boolean, opcional): Valor padrão para campos checkboxlength
(string, obrigatório): Comprimento para campos numéricos/textodecimalPlace
(string, obrigatório): Casas decimais para campos numéricospickListValues
(string, obrigatório): Valores para campos picklist (separados por novas linhas)visibleLines
(string, obrigatório): Linhas visíveis para campos multiseleção/área de textodescription
(string, opcional): Descrição do campohelperText
(string, opcional): Texto de ajuda exibido ao passar o mousedefaultFieldValue
(string, opcional): Valor padrão do campo
Descrição: Crie campos personalizados para objetos de Oportunidade.
Parâmetros:
label
(string, obrigatório): Rótulo do campo para exibições e referência internatype
(string, obrigatório): Tipo do campo - Opções: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, LongTextArea, Html, Time, UrldefaultCheckboxValue
(boolean, opcional): Valor padrão para campos checkboxlength
(string, obrigatório): Comprimento para campos numéricos/textodecimalPlace
(string, obrigatório): Casas decimais para campos numéricospickListValues
(string, obrigatório): Valores para campos picklist (separados por novas linhas)visibleLines
(string, obrigatório): Linhas visíveis para campos multiseleção/área de textodescription
(string, opcional): Descrição do campohelperText
(string, opcional): Texto de ajuda exibido ao passar o mousedefaultFieldValue
(string, opcional): Valor padrão do campo
Descrição: Crie campos personalizados para objetos de Tarefa.
Parâmetros:
label
(string, obrigatório): Rótulo do campo para exibições e referência internatype
(string, obrigatório): Tipo do campo - Opções: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, Time, UrldefaultCheckboxValue
(boolean, opcional): Valor padrão para campos checkboxlength
(string, obrigatório): Comprimento para campos numéricos/textodecimalPlace
(string, obrigatório): Casas decimais para campos numéricospickListValues
(string, obrigatório): Valores para campos picklist (separados por novas linhas)visibleLines
(string, obrigatório): Linhas visíveis para campos multiseleçãodescription
(string, opcional): Descrição do campohelperText
(string, opcional): Texto de ajuda exibido ao passar o mousedefaultFieldValue
(string, opcional): Valor padrão do campo
Descrição: Crie campos personalizados para objetos de Conta.
Parâmetros:
label
(string, obrigatório): Rótulo do campo para exibições e referência internatype
(string, obrigatório): Tipo do campo - Opções: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, LongTextArea, Html, Time, UrldefaultCheckboxValue
(boolean, opcional): Valor padrão para campos checkboxlength
(string, obrigatório): Comprimento para campos numéricos/textodecimalPlace
(string, obrigatório): Casas decimais para campos numéricospickListValues
(string, obrigatório): Valores para campos picklist (separados por novas linhas)visibleLines
(string, obrigatório): Linhas visíveis para campos multiseleção/área de textodescription
(string, opcional): Descrição do campohelperText
(string, opcional): Texto de ajuda exibido ao passar o mousedefaultFieldValue
(string, opcional): Valor padrão do campo
Descrição: Crie campos personalizados para qualquer tipo de objeto.
Nota: Esta é uma ferramenta flexível para criar campos personalizados para tipos de objetos personalizados ou desconhecidos.
Operações Avançadas
Descrição: Execute consultas SOQL personalizadas em seus dados do Salesforce.
Parâmetros:
query
(string, obrigatório): Consulta SOQL (ex.: “SELECT Id, Name FROM Account WHERE Name = ‘Exemplo’”)
Descrição: Crie um novo objeto personalizado no Salesforce.
Parâmetros:
label
(string, obrigatório): Rótulo do objeto para abas, layouts de página e relatóriospluralLabel
(string, obrigatório): Rótulo plural (ex.: “Contas”)description
(string, opcional): Uma descrição do Objeto PersonalizadorecordName
(string, obrigatório): Nome do registro exibido em layouts e buscas (ex.: “Nome da Conta”)
Descrição: Obtenha o schema esperado para operações em tipos de objetos específicos.
Parâmetros:
recordType
(string, obrigatório): Tipo de registro a ser detalhadooperation
(string, obrigatório): Tipo de Operação (ex.: “CREATE_RECORD” ou “UPDATE_RECORD”)
Nota: Use esta função primeiro ao trabalhar com objetos personalizados para entender seu schema antes de realizar operações.
Exemplos de Uso
Configuração Básica de um Agente Salesforce
from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools
# Obtenha ferramentas enterprise (ferramentas Salesforce serão incluídas)
enterprise_tools = CrewaiEnterpriseTools(
enterprise_token="your_enterprise_token"
)
# Crie um agente com capacidades Salesforce
salesforce_agent = Agent(
role="CRM Manager",
goal="Manage customer relationships and sales processes efficiently",
backstory="An AI assistant specialized in CRM operations and sales automation.",
tools=[enterprise_tools]
)
# Task to create a new lead
create_lead_task = Task(
description="Create a new lead for John Doe from Example Corp with email john.doe@example.com",
agent=salesforce_agent,
expected_output="Lead created successfully with lead ID"
)
# Run the task
crew = Crew(
agents=[salesforce_agent],
tasks=[create_lead_task]
)
crew.kickoff()
Filtrando Ferramentas Salesforce Específicas
from crewai_tools import CrewaiEnterpriseTools
# Obtenha apenas ferramentas Salesforce específicas
enterprise_tools = CrewaiEnterpriseTools(
enterprise_token="your_enterprise_token",
actions_list=["salesforce_create_record_lead", "salesforce_update_record_opportunity", "salesforce_search_records_contact"]
)
sales_manager = Agent(
role="Sales Manager",
goal="Manage leads and opportunities in the sales pipeline",
backstory="An experienced sales manager who handles lead qualification and opportunity management.",
tools=enterprise_tools
)
# Task to manage sales pipeline
pipeline_task = Task(
description="Create a qualified lead and convert it to an opportunity with $50,000 value",
agent=sales_manager,
expected_output="Lead created and opportunity established successfully"
)
crew = Crew(
agents=[sales_manager],
tasks=[pipeline_task]
)
crew.kickoff()
Gerenciamento de Contatos e Contas
from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools
enterprise_tools = CrewaiEnterpriseTools(
enterprise_token="your_enterprise_token"
)
account_manager = Agent(
role="Account Manager",
goal="Manage customer accounts and maintain strong relationships",
backstory="An AI assistant that specializes in account management and customer relationship building.",
tools=[enterprise_tools]
)
# Task to manage customer accounts
account_task = Task(
description="""
1. Create a new account for TechCorp Inc.
2. Add John Doe as the primary contact for this account
3. Create a follow-up task for next week to check on their project status
""",
agent=account_manager,
expected_output="Account, contact, and follow-up task created successfully"
)
crew = Crew(
agents=[account_manager],
tasks=[account_task]
)
crew.kickoff()
Consultas SOQL Avançadas e Relatórios
from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools
enterprise_tools = CrewaiEnterpriseTools(
enterprise_token="your_enterprise_token"
)
data_analyst = Agent(
role="Sales Data Analyst",
goal="Generate insights from Salesforce data using SOQL queries",
backstory="An analytical AI that excels at extracting meaningful insights from CRM data.",
tools=[enterprise_tools]
)
# Complex task involving SOQL queries and data analysis
analysis_task = Task(
description="""
1. Execute a SOQL query to find all opportunities closing this quarter
2. Search for contacts at companies with opportunities over $100K
3. Create a summary report of the sales pipeline status
4. Update high-value opportunities with next steps
""",
agent=data_analyst,
expected_output="Comprehensive sales pipeline analysis with actionable insights"
)
crew = Crew(
agents=[data_analyst],
tasks=[analysis_task]
)
crew.kickoff()
Esta documentação abrangente cobre todas as ferramentas Salesforce organizadas por funcionalidade, facilitando que os usuários encontrem as operações específicas de que necessitam para automação de seu CRM.
Precisa de ajuda?
Precisa de ajuda?
Entre em contato com nossa equipe de suporte para assistência na configuração da integração com Salesforce ou para resolução de problemas.
Esta página foi útil?
- Visão Geral
- Pré-requisitos
- Ferramentas Disponíveis
- Gerenciamento de Registros
- Atualização de Registros
- Recuperação de Registros
- Busca de Registros
- Recuperação por List View
- Campos Personalizados
- Operações Avançadas
- Exemplos de Uso
- Configuração Básica de um Agente Salesforce
- Filtrando Ferramentas Salesforce Específicas
- Gerenciamento de Contatos e Contas
- Consultas SOQL Avançadas e Relatórios
- Precisa de ajuda?