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 AMP com assinatura ativa
- Uma conta Salesforce com permissões apropriadas
- Sua conta Salesforce conectada via a página de Integrações
Configurando a Integração Salesforce
1. Conecte sua Conta Salesforce
- Acesse CrewAI AMP Integrações
- Encontre Salesforce na seção Integrações de Autenticação
- Clique em Conectar e complete o fluxo OAuth
- Conceda as permissões necessárias para gerenciamento de CRM e vendas
- Copie seu Token Enterprise em Configurações de Integração
2. Instale o Pacote Necessário
3. Configuração de variável de ambiente
Agent(apps=[]), você deve definir a variável de ambiente CREWAI_PLATFORM_INTEGRATION_TOKEN com seu Enterprise Token..env:
Ferramentas Disponíveis
Gerenciamento de Registros
salesforce/create_record_contact
salesforce/create_record_contact
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
salesforce/create_record_lead
salesforce/create_record_lead
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
salesforce/create_record_opportunity
salesforce/create_record_opportunity
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
salesforce/create_record_task
salesforce/create_record_task
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
salesforce/create_record_account
salesforce/create_record_account
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
salesforce/create_record_any
salesforce/create_record_any
Atualização de Registros
salesforce/update_record_contact
salesforce/update_record_contact
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
salesforce/update_record_lead
salesforce/update_record_lead
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
salesforce/update_record_opportunity
salesforce/update_record_opportunity
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
salesforce/update_record_task
salesforce/update_record_task
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
salesforce/update_record_account
salesforce/update_record_account
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
salesforce/update_record_any
salesforce/update_record_any
Recuperação de Registros
salesforce/get_record_by_id_contact
salesforce/get_record_by_id_contact
recordId(string, obrigatório): ID do registro do Contato
salesforce/get_record_by_id_lead
salesforce/get_record_by_id_lead
recordId(string, obrigatório): ID do registro do Lead
salesforce/get_record_by_id_opportunity
salesforce/get_record_by_id_opportunity
recordId(string, obrigatório): ID do registro da Oportunidade
salesforce/get_record_by_id_task
salesforce/get_record_by_id_task
recordId(string, obrigatório): ID do registro da Tarefa
salesforce/get_record_by_id_account
salesforce/get_record_by_id_account
recordId(string, obrigatório): ID do registro da Conta
salesforce/get_record_by_id_any
salesforce/get_record_by_id_any
recordType(string, obrigatório): Tipo do registro (ex.: “CustomObject__c”)recordId(string, obrigatório): ID do registro
Busca de Registros
salesforce/search_records_contact
salesforce/search_records_contact
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
salesforce/search_records_lead
salesforce/search_records_lead
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
salesforce/search_records_opportunity
salesforce/search_records_opportunity
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
salesforce/search_records_task
salesforce/search_records_task
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
salesforce/search_records_account
salesforce/search_records_account
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
salesforce/search_records_any
salesforce/search_records_any
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
salesforce/get_record_by_view_id_contact
salesforce/get_record_by_view_id_contact
listViewId(string, obrigatório): ID do List ViewpaginationParameters(object, opcional): Configurações de paginação com pageCursor
salesforce/get_record_by_view_id_lead
salesforce/get_record_by_view_id_lead
listViewId(string, obrigatório): ID do List ViewpaginationParameters(object, opcional): Configurações de paginação com pageCursor
salesforce/get_record_by_view_id_opportunity
salesforce/get_record_by_view_id_opportunity
listViewId(string, obrigatório): ID do List ViewpaginationParameters(object, opcional): Configurações de paginação com pageCursor
salesforce/get_record_by_view_id_task
salesforce/get_record_by_view_id_task
listViewId(string, obrigatório): ID do List ViewpaginationParameters(object, opcional): Configurações de paginação com pageCursor
salesforce/get_record_by_view_id_account
salesforce/get_record_by_view_id_account
listViewId(string, obrigatório): ID do List ViewpaginationParameters(object, opcional): Configurações de paginação com pageCursor
salesforce/get_record_by_view_id_any
salesforce/get_record_by_view_id_any
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
salesforce/create_custom_field_contact
salesforce/create_custom_field_contact
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
salesforce/create_custom_field_lead
salesforce/create_custom_field_lead
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
salesforce/create_custom_field_opportunity
salesforce/create_custom_field_opportunity
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
salesforce/create_custom_field_task
salesforce/create_custom_field_task
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
salesforce/create_custom_field_account
salesforce/create_custom_field_account
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
salesforce/create_custom_field_any
salesforce/create_custom_field_any
Operações Avançadas
salesforce/write_soql_query
salesforce/write_soql_query
query(string, obrigatório): Consulta SOQL (ex.: “SELECT Id, Name FROM Account WHERE Name = ‘Exemplo’”)
salesforce/create_custom_object
salesforce/create_custom_object
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”)
salesforce/describe_action_schema
salesforce/describe_action_schema
recordType(string, obrigatório): Tipo de registro a ser detalhadooperation(string, obrigatório): Tipo de Operação (ex.: “CREATE_RECORD” ou “UPDATE_RECORD”)
