Ações Salesforce

As ações Salesforce permitem interações com a API do Salesforce.

Todas as ações do Salesforce devem usar a instância de conexão Salesforce, criada pela ação login.

Configuração da Conexão

Estabelece uma conexão com o Salesforce usando as credenciais fornecidas.

Parâmetros:

username - Nome de usuário da conta do Salesforce.
password - Senha da conta do Salesforce.
token - Token de segurança fornecido pelo Salesforce.
client_id (Opcional)- ID do cliente para aplicativos personalizados.
domain (Opcional)- Domínio do Salesforce.
organizationId (Opcional)- ID da organização para acesso multi-inquilino.

Retorno:

sf_connection - Instância de conexão do Salesforce para interações adicionais com a API.

Ações

query

Executa uma consulta SOQL e recupera dados do Salesforce, lidando com a paginação.

Parâmetros:

sf_connection - Instância do Salesforce fornecida por login.
query - String da consulta SOQL a ser executada.

Retorno:

result - Lista de todos os registros recuperados.
total_size - Número total de registros que correspondem à consulta.

update

Atualiza ou insere um registro no objeto Contact do Salesforce.

Parâmetros:

sf_connection - Instância do Salesforce fornecida por login.
id - Identificador único do registro a ser atualizado.
values - Dicionário contendo os campos a serem atualizados e seus novos valores.

Retorno:

status - Resposta indicando o resultado da operação de atualização/inserção (upsert).

describe

Recupera metadados para o objeto Contact ou o layout de um registro específico de Contact.

Parâmetros:

sf_connection - Instância do Salesforce fornecida por login.
id (Opcional)- ID do registro específico de Contact para descrição do layout.

Retorno:

items - Lista de dicionários para cada campo, contendo:
- label - Nome do campo para leitura humana.
- name - Nome do campo na API.
- type - Tipo de dado do campo (ex.: string, número).
- referenceTo - Objetos relacionados do Salesforce, se aplicável.