Ligar a FileMaker ao Salesforce

6. scripting personalizado para integrações especializadas

Nalguns casos, pode fazer sentido desenvolver soluções de scripting personalizadas na FileMaker para cumprir requisitos específicos de integração do Salesforce. Os scripts personalizados permitem criar fluxos de trabalho e funções personalizados que são precisamente adaptados às necessidades da empresa.

Exemplo de aplicação para scripting personalizado

• Gestão de contactosUma empresa pode criar um script personalizado que transfere automaticamente novos leads do FileMaker para o Salesforce, tendo em conta determinadas regras e condições, como o estado do lead ou o território de vendas.

Vantagens de integrar a FileMaker/gFM Business e a Salesforce

• Coerência dos dadosA integração significa que os dados dos clientes, as encomendas e as oportunidades de venda permanecem sincronizados entre os sistemas, o que garante uma base de dados central e actualizada.
• AutomatizaçãoAs tarefas recorrentes, como a transferência de contactos ou de informações sobre clientes, podem ser automatizadas, o que reduz o tempo necessário e minimiza os erros.
• FlexibilidadeAo utilizar APIs, middleware ou ODBC, pode conceber a integração de forma flexível e adaptá-la aos requisitos específicos da sua empresa.
• Acesso aos dados em tempo realCom métodos como a ligação ODBC ou a utilização da API REST, as empresas podem aceder aos dados em tempo real e, assim, tomar melhores decisões com base em informações actualizadas.

Script de amostra do FileMaker para o Salesforce REST API

Abaixo está um exemplo de um script do FileMaker que se conecta ao Salesforce REST API e envia uma solicitação. Este exemplo mostra como se pode autenticar e depois recuperar ou enviar registos do Salesforce.

Pré-requisitos:

• URL da API REST do SalesforceO URL que utiliza para aceder ao Salesforce.
• ID do cliente e segredo do cliente do Salesforce: Receberá isto depois de registar a sua aplicação no Salesforce.
• Token OAuth2O OAuth2 é utilizado para autenticação para garantir o acesso seguro ao Salesforce.

Exemplo de script para conectar o FileMaker ao Salesforce:

1. autenticação e recuperação de fichas

Para estabelecer uma ligação, é necessário um token de acesso, que recebe do Salesforce através de um pedido OAuth2.

# Definir as variáveis para a autenticação do Salesforce
Definir variável [ $client_id ; Valor: "Your_Client_ID" ]
Definir variável [ $client_secret ; Valor: "Your_Client_Secret" ]
Definir variável [ $username ; Valor: "Your_Salesforce_username" ]
Definir variável [ $password ; Valor: "Your_Salesforce_Password" & "Your_Security_Token" ] # Password + Security Token combinados
Definir variável [ $auth_url ; Valor: "https://login.salesforce.com/services/oauth2/token" ]

# Criação das opções cURL para o pedido de autenticação
Definir variável [ $postData ; Valor:
"grant_type=password&client_id=" & $client_id &
"&client_secret=" & $client_secret &
"&username=" & $username &
"&password=" & $password ]

# Enviar pedido de autenticação para o Salesforce
Inserir a partir de URL [ Seleção ; Diálogo: Off ; $auth_response ; $auth_url ; Opções cURL: "--request POST --data " & $postData ]

Extrair o Token de Acesso #
Definir variável [ $access_token ; Valor: JSONGetElement ( $auth_response ; "access_token" ) ]
Definir variável [ $instance_url ; Value: JSONGetElement ( $auth_response ; "instance_url" ) ]
Depois de receber o Token de acesso, pode utilizá-lo para aceder à API do Salesforce.

2. recuperar dados do Salesforce
Neste exemplo, recuperamos uma lista de contas (clientes) do Salesforce.

# Definir o URL para o pedido de API
Definir variável [ $api_url ; Valor: $instance_url & "/services/data/v50.0/sobjects/Account" ]

# Definir as opções cURL com o token de acesso
Definir variável [ $cURL_options ; Valor:
"--header \"Authorisation: Bearer " & $access_token & "\"¶" &
"--header \"Content-Type: application/json\"¶" &
"--header \"Accept: application/json\"" ]

# Enviar o pedido GET ao Salesforce para recuperar os dados da conta
Inserir a partir de URL [ Seleção ; Diálogo: Off ; $response ; $api_url ; cURL-Options: $cURL_options ]

# Apresentar a resposta da API na caixa de diálogo (por exemplo, como JSON)
Definir variável [ $formatted_response ; Valor: JSONFormatElements( $response ) ]
Apresentar a própria caixa de diálogo [ "Resposta API" ; $formatted_response ]

3. processamento dos dados na FileMaker

Pode agora processar os dados e inseri-los na sua base de dados FileMaker.

# Exemplo: Extrair o primeiro nome de conta da resposta JSON
Definir variável [ $account_name ; Value: JSONGetElement ( $response ; "records[0].Name" ) ]

# Guardar o nome da conta num campo FileMaker
Definir o valor do campo [ Customers::Name ; $account_name ]

Explicação do guião

• AutenticaçãoVocê envia um pedido OAuth2 ao Salesforce para obter um token de acesso. Esse token é usado em todas as solicitações subsequentes para autenticar os dados do Salesforce.
• Recuperação de dadosCom o token de acesso, você envia uma solicitação GET ao Salesforce para recuperar dados da conta. A resposta é retornada no formato JSON.
• Processamento de dadosOs dados recuperados são guardados no FileMaker. Neste exemplo, o primeiro nome de conta é extraído e inserido num campo FileMaker.

Ajustes:

• Pontos finaisPode alterar os endpoints para aceder a outros objectos, como leads, oportunidades ou objectos personalizados.
• Tratamento de errosÉ aconselhável adicionar consultas de erro para garantir que o processo se mantém sem problemas no caso de consultas incorrectas.
• Outros domíniosPode extrair campos adicionais e guardá-los na FileMaker, dependendo dos seus requisitos.