Update salesforce.md

.github/workflows/trigger-embed.yml

@@ -0,0 +1,22 @@
+name: Trigger Embed Service
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  trigger-embed:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger Embed Service
+        env: # The API keys are the same as those used by the AI Assistant. There is only one (production) database. 
+          PINECONE_API_KEY: ${{ secrets.PINECONE_API_KEY }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+        run: |
+          curl -X POST https://apollo.staging.openfn.org/services/embed_docsite \
+            -H "Content-Type: application/json" \
+            -d '{
+              "pinecone_api_key": "${{ secrets.PINECONE_API_KEY }}",
+              "openai_api_key": "${{ secrets.OPENAI_API_KEY }}"
+            }'

README.md

@@ -5,7 +5,7 @@ site._**
 
 ## Contributing to this documentation site
 
-Visit https://docs.openfn.org/documentation/writing-docs/.
+Visit: https://docs.openfn.org/documentation/writing-docs/
 
 This website is built using [Docusaurus](https://docusaurus.io/), a static
 website generator that uses Markdown and Javascript.

adaptors/asana.md

@@ -0,0 +1,44 @@
+---
+title: Asana Adaptor
+---
+
+## About Asana
+
+[Asana](https://app.asana.com/) is a web-based project management tool that helps teams organize, plan, collaborate, and execute tasks. 
+
+## Integration Options
+
+Asana supports 2 primary integration options:
+
+1. Rest API: Asana has an available REST API that enables external services like OpenFn to pull data from Asana, or push data from external apps to Asana. This option is suited for scheduled, bulk syncs or workflows that must update data in Asana with external information. See [functions](/adaptors/packages/asana-docs) for more on how to use this adaptor to work with the API.
+
+2. Webhook: Asana also has a [Webhook or Data Forwarding](https://developers.asana.com/docs/webhooks-guide) to push data from Asana to external systems. This option is suited for real-time, event-based data integration. Check out the Asana [developer documentation](/adaptors/packages/asana-docs) to learn how to set up a webhook to push data to OpenFn.
+
+## Authentication
+
+See [Asana docs](https://developers.asana.com/docs/authentication) for the latest on supported authentication methods. 
+
+When integrating with Asana via OpenFn, there is one primary authentication method that is supported: **Personal Access Token (PAT)**. You can generate a personal access token from the Asana [developer console](https://developers.asana.com/docs/personal-access-token).
+
+See this adaptor's [Configuration docs](/adaptors/packages/asana-configuration-schema) for more on the required authentication parameters.
+
+See platform docs on [managing credentials](/documentation/manage-projects/manage-credentials) for how to configure a credential in OpenFn. If working locally or if using a Raw JSON credential type, then your configuration will look something like this:
+
+```
+{
+  "apiVersion": "1.0",
+  "token": "sample-tokenyWSJdXBACMLLWMNGgADFA"
+}
+```
+
+### Helpful Links
+
+1. [API documentation](https://developers.asana.com/docs/overview)
+
+### Implementation Examples
+
+1. The Wildlife Conservation Society (WCS) - KoboToolBox -> GoogleSheets -> Asana sync: [https://openfn.github.io/ConSoSci/asana/](https://openfn.github.io/ConSoSci/asana/)
+
+
+
+

adaptors/azure-storage.md

@@ -0,0 +1,40 @@
+---
+title: Azure Storage 
+---
+
+## About Azure Storage 
+
+[Azure Storage](https://azure.microsoft.com/en-us/products/category/storage) is a cloud-based storage solution provided by Microsoft Azure. It offers scalable and secure storage options for a wide range of data, including unstructured, semi-structured, and structured data. 
+## Integration Options
+
+Azure Storage supports 2 primary integration options with OpenFn:
+
+1. **Rest API:** Azure Storage has a REST API that enables external services like OpenFn to pull data from Azure Storage, or push data from external apps to Azure Storage. This option is suited for scheduled, bulk syncs or workflows that must update data in Azure Storage with external information. See [functions](/adaptors/packages/azure-storage-docs) for more on how to use this adaptor to work with the API.
+2. **Webhook:** Webhook or Data Forwarding to push data from Azure Storage to external systems (see [docs](https://learn.microsoft.com/en-us/azure/storage/)). This option is suited for real-time, event-based data integration.
+
+## Authentication
+
+1. See [Azure Storage docs](https://learn.microsoft.com/en-us/azure/storage/) for the latest on supported authentication methods.
+2. When integrating with Azure Storage via OpenFn, there is one primary authentication method that is supported: **API Key**. See this adaptor's [Configuration docs](/adaptors/packages/azure-storage-configuration-schema) for more on the required authentication parameters.
+
+See platform docs on [managing credentials](/documentation/manage-projects/manage-credentials) for how to configure a credential in OpenFn. If working locally or if using a Raw JSON credential type, then your configuration will look something like this:
+
+```
+{
+  "accountName": "examplestorageaccount01",
+  "accountKey": "zzUx5rA4BZkjPet8ztLTEll7azF65Sez7WxGKsJv5B+rp/dby8ARgYpEVe93xFCQDqGBi3FUlxjP+ASt4uepZg=="
+}
+```
+
+### Helpful Links
+
+1. [Azure Storage Documentation](https://learn.microsoft.com/en-us/azure/storage/)
+2. [Azure Blob Storage REST API](https://learn.microsoft.com/en-us/rest/api/storageservices/)
+
+### Implementation Examples
+
+_Coming soon!_
+
+
+
+

adaptors/beyonic.md

@@ -0,0 +1,42 @@
+---
+title: Beyonic 
+---
+
+## About Beyonic
+
+Beyonic is a digital payments platform that supports mobile money payments, collections, and bulk disbursements, offering integration with major mobile network operators and banks. 
+
+## Integration Options
+
+Beyonic supports 2 primary integration options with OpenFn:
+
+1. **Rest API:** Beyonic has a REST API that enables external services like OpenFn to pull data from Beyonic, or push data from external apps to Beyonic. This option is suited for scheduled, bulk syncs or workflows that must update data in Beyonic with external information. See [functions](/adaptors/packages/beyonic-docs) for more on how to use this adaptor to work with the API.
+2. **Webhook:** Webhook or Data Forwarding to push data from Beyonic to external systems (see [docs](https://apidocs.beyonic.com/webhooks)). This option is suited for real-time, event-based data integration.
+
+## Authentication
+
+1. See [Beyonic docs](https://apidocs.beyonic.com) for the latest on supported authentication methods.
+2. When integrating with Beyonic via OpenFn, there is one primary authentication method that is supported: **API Key**. See this adaptor's [Configuration docs](/adaptors/packages/beyonic-configuration-schema) for more on the required authentication parameters.
+
+See platform docs on [managing credentials](/documentation/manage-projects/manage-credentials) for how to configure a credential in OpenFn. If working locally or if using a Raw JSON credential type, then your configuration will look something like this:
+
+```
+{
+  "apiUrl": "https://beyonic.com/api",
+  "apiToken": "cdjhiooiSIUJHDYSYUIHASIOHKAANOAJJjsiujhaka"
+}
+```
+
+### Helpful Links
+
+1. [Beyonic Documentation](https://apidocs.beyonic.com)
+2. [Beyonic API Reference](https://apidocs.beyonic.com/reference)
+3. [Webhook Guide](https://apidocs.beyonic.com/webhooks)
+
+### Implementation Examples
+
+_Coming soon!_
+
+
+
+

adaptors/bigquery.md

@@ -0,0 +1,50 @@
+---
+title: Big Query 
+---
+
+## About Big Query 
+
+BigQuery is Google Cloud’s fully managed, serverless, and highly scalable data warehouse solution. It enables organizations to store, analyze, and visualize large datasets using SQL queries, machine learning, and real-time analytics. 
+
+## Integration Options
+
+BigQuery supports 2 primary integration options with OpenFn:
+
+1. **Rest API:** BigQuery has a REST API that enables external services like OpenFn to pull data from BigQuery, or push data from external apps to BigQuery. This option is suited for scheduled, bulk syncs or workflows that must update data in BigQuery with external information. See [functions](/adaptors/packages/bigquery-docs) for more on how to use this adaptor to work with the API.
+2. **Webhook:** Webhook or Data Forwarding to push data from BigQuery to external systems (see [docs](https://cloud.google.com/run/docs/triggering/webhooks)). This option is suited for real-time, event-based data integration.
+
+## Authentication
+
+1. See [BigQuery docs](https://cloud.google.com/bigquery/docs) for the latest on supported authentication methods.
+2. When integrating with BigQuery via OpenFn, there is one primary authentication method that is supported: **API Key**. See this adaptor's [Configuration docs](/adaptors/packages/bigquery-configuration-schema) for more on the required authentication parameters.
+
+See platform docs on [managing credentials](/documentation/manage-projects/manage-credentials) for how to configure a credential in OpenFn. If working locally or if using a Raw JSON credential type, then your configuration will look something like this:
+
+```
+{
+  "type": "service_acconut",
+  "project_id": "some-project-id",
+  "private_key_id": "670b9e3c8c366e83aa569dd57cbfc5c575b72e42",
+  "private_key": "-----BEGIN PRIVATE KEY-----\nblah\nmoreblah=\n-----END PRIVATE KEY-----\n",
+  "client_email": "bigquery@some-project.iam.gserviceaccount.com",
+  "client_id": "someid",
+  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
+  "token_uri": "https://oauth2.googleapis.com/token",
+  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
+  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/bigquery%40some-project.iam.gserviceaccount.com"
+}
+```
+
+### Helpful Links
+
+1. [BigQuery Documentation](https://cloud.google.com/bigquery/docs)
+2. [BigQuery REST API](https://cloud.google.com/bigquery/docs/reference/rest)
+
+
+### Implementation Examples
+
+_Coming soon!_
+
+
+
+

adaptors/chatgpt.md

@@ -0,0 +1,47 @@
+---
+title: ChatGPT AI Adaptor
+---
+
+## About ChatGPT
+
+[ChatGPT](https://chatgpt.com/) is an AI assistant built by OpenAI. It provides
+a family of large language models (LLMs) developed for natural language
+processing tasks such as text generation, summarization, and question answering.
+
+ChatGPT models process text input to generate responses but do not have built-in
+memory or autonomous decision-making. They can be integrated with external tools
+or APIs to execute actions beyond text-based outputs.
+
+## Use OpenFn + LLMs for AI-Driven Workflows
+
+While LLMs (like Claude or ChatGPT) can generate insights, recommendations, or
+structured data, they often **lack direct execution capabilities**—meaning they
+need an automation system to act on their outputs.
+
+**OpenFn workflows fill this gap by orchestrating actions based on LLM-generated
+responses.**
+
+Remember that LLMs are imperfect. Learn more about your recommended approach to
+AI in our [Responsible AI Policy](https://www.openfn.org/ai).
+
+## Integration Options
+
+Use this adpator to integrate with the
+[OpenAI Platform API](https://platform.openai.com/docs/overview), to integrate
+ChatGPT AI models into your workflows to leverage their natural language
+processing (NLP) capabilities.
+
+Example AI-driven workflow on OpenFn:
+![ai-driven-workflow](/img/ai-workflow-example.webp)
+
+## Authentication
+
+See this adaptor's
+[Configuration docs](/adaptors/packages/chatgpt-configuration-schema) for
+technical docs on the authentication parameters required.
+
+## Helpful Links
+
+- About ChatGPT: https://chatgpt.com/
+- API docs: https://platform.openai.com/docs/overview
+- API Intro: https://www.chatbase.co/blog/chatgpt-api

adaptors/claude.md

@@ -0,0 +1,45 @@
+---
+title: Claude AI Adaptor
+---
+
+## About Claude
+
+[Claude](https://claude.ai/) is an AI assistant built by Anthropic. It provides
+a family of large language models (LLMs) developed for natural language
+processing tasks such as text generation, summarization, and question answering.
+
+Claude models process text input to generate responses but do not have built-in
+memory or autonomous decision-making. They can be integrated with external tools
+or APIs to execute actions beyond text-based outputs.
+
+## Use OpenFn + LLMs for AI-Driven Workflows
+
+While LLMs (like Claude or ChatGPT) can generate insights, recommendations, or
+structured data, they often **lack direct execution capabilities**—meaning they
+need an automation system to act on their outputs.
+
+**OpenFn workflows fill this gap by orchestrating actions based on LLM-generated
+responses.**
+
+Remember that LLMs are imperfect. Learn more about your recommended approach to
+AI in our [Responsible AI Policy](https://www.openfn.org/ai).
+
+## Integration Options
+
+Use this adpator to integrate with the
+[Claude API](https://www.anthropic.com/api), to integrate Claude AI models into
+your workflows to leverage their natural language processing (NLP) capabilities.
+
+Example AI-driven workflow on OpenFn:
+![ai-driven-workflow](/img/ai-workflow-example.webp)
+
+## Authentication
+
+See this adaptor's
+[Configuration docs](/adaptors/packages/claude-configuration-schema) for
+technical docs on the authentication parameters required.
+
+## Helpful Links
+
+- About Claude: https://claude.ai/
+- API docs: https://www.anthropic.com/api