User Tools

Site Tools


salesforce

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
salesforce [2021/04/29 04:26]
windsor_ai
salesforce [2021/06/17 11:59] (current)
windsor_ai
Line 1: Line 1:
 ====== Salesforce ====== ====== Salesforce ======
  
-=== Working with the Salesforce connector ===+===== General Overview =====
  
 The Salesforce CRM connector lets you pull Salesforce data on an object level. The currently supported objects are: The Salesforce CRM connector lets you pull Salesforce data on an object level. The currently supported objects are:
Line 14: Line 14:
  
 Sample query: Sample query:
-<code>https://connectors.windsor.ai/salesforce?api_key=[your API key]&date_preset=last_7d&fields=contact_firstname,contact_lastname,contact_email,contact_phone&_renderer=csv</code>+<code> https://connectors.windsor.ai/salesforce?api_key=(your API key)&date_preset=last_7d&fields=contact_firstname,contact_lastname,contact_email,contact_phone&_renderer=csv </code>
  
-=== Date range ===+===== Frequently asked questions =====
  
-  * RelativeFilter for a relative date range in which the objects requested were last modified at (e.g. Contact Last Modified Date for any field related to Contacts). Example: date_preset=last_7d +==== How to work with dates in the Salesforce connector? ==== 
-  * AbsoluteFilter for an absolute date range in which the objects requested were last modified at (e.g. Contact Last Modified Date for any field related to Contacts). Example date_from=2021-01-01&date_to=2021-03-31 + 
-  * None: If neither absolute or relative date ranges are specified data from the requested objects last modified in the last 3days (e.g. Contact Last Modified Date for any field related to Contacts) will be returned.+  * **Relative** \\ Filter for a relative date range in which the objects requested were last modified at (e.g. Contact Last Modified Date for any field related to Contacts). \\ Example: <code> &date_preset=last_7d</code> 
 + 
 +  * **Absolute** \\ Filter for an absolute date range in which the objects requested were last modified at (e.g. Contact Last Modified Date for any field related to Contacts). \\ Example <code>&date_from=2021-01-01&date_to=2021-03-31</code> 
 + 
 +  * **Not specified** \\ If neither absolute or relative date ranges are specified from the requested objects last modified in the last 3days (e.g. Contact Last Modified Date for any field related to Contacts) will be returned. 
 + 
 +==== How to work with custom fields and custom objects? ==== 
 + 
 +In case your Salesforce instance has custom fields and custom objects you can also query them. The syntax is slightly different. First of all you would need to identify the ***API Name*** of the custom field. You can do so by navigating to Setup -> Customize -> Under any Standard Object -> Fields.  
 + 
 +You can then find the API name 
 + 
 +{{ :salesforce_custom_fields_api_name.png?nolink&200 |}} 
 + 
 +Custom fields can be identified easily as they either end with "__c" or "__pc". The same rule applies for custom objects. 
 + 
 +To build a query this way you specify the object name with square brackets followed by the field name. 
 + 
 +Example: 
 + 
 + 
 +<code>[Campaign]External_Display_Name__c </code> 
 + 
 + 
 +Will retrieve the custom field External Display Name from the standard **Campaign object**. 
 + 
 +<code> 
 +[Sales_Order__c]TOTAL_Invoice_Price__c 
 +</code> 
 + 
 +Will retrieve the custom field **TOTAL Invoice Price** from the custom **Sales Order Object**. 
 + 
 +The complete API URLs will look like this 
 + 
 +<code> https://connectors.windsor.ai/salesforce?fields=[Sales_Order__c]TOTAL_Invoice_Price__c,[Sales_Order__c]Opportunity__c,[Sales_Order__c]Account__c,[Account]Id,[Account]Mobile_Preferred__pc,[Account]Default_Email__c,[Opportunity]Id,[Opportunity]CampaignId,[Opportunity]AccountId&date_from=2021-03-01&date_to=2021-03-05&api_key=(your API key) </code> 
 + 
 + 
 +and the response would look similar to this: 
 + 
 +<code>"data":
 +    { 
 +        "[account]default_email__c": null, 
 +        "[opportunity]campaignid": "campaign id", 
 +        "[account]id": null, 
 +        "[account]mobile_preferred__pc": null, 
 +        "[sales_order__c]opportunity__c": null, 
 +        "[sales_order__c]account__c": null, 
 +        "[opportunity]accountid": "account id", 
 +        "[opportunity]id": "opportunity id", 
 +        "[sales_order__c]total_invoice_price__c": null 
 +    }, 
 +    ...</code>
salesforce.1619666762.txt.gz · Last modified: 2021/04/29 04:26 by windsor_ai