Skip to content

forcedotcom/sf-skills / plugins/builder/integration/skills/integration-connectivity-generate

integration-connectivity-generate

Verified

Salesforce integration architecture and runtime plumbing with 120-point scoring. Use this skill to set up Named Credentials, External Credentials, External Services, REST/SOAP callout patterns, Platform Events, and Change Data Capture. TRIGGER when: user sets up Named Credentials, External Services, REST/SOAP callouts, Platform Events, CDC, or touches .namedCredential-meta.xml files. DO NOT TRIGGER when: Connected App/OAuth config (use integration-connectivity-connected-app-configure), Apex-only logic (use platform-apex-generate), data import/export (use platform-data-manage), or CDC channel-membership metadata such as PlatformEventChannel, PlatformEventChannelMember, or EnrichedField (use integration-eventing-cdc-configure).

FileKindSize
README.mdmarkdown3.5 KB
SKILL.mdskill md8.8 KB
assets/callouts/callout-retry-handler.clsother6.0 KB
assets/callouts/http-response-handler.clsother8.5 KB
assets/callouts/rest-queueable-callout.clsother8.8 KB
assets/callouts/rest-sync-callout.clsother7.4 KB
assets/cdc/cdc-handler.clsother8.4 KB
assets/cdc/cdc-subscriber-trigger.triggerother5.3 KB
assets/endpoint-security/example.cspTrustedSite-meta.xmlconfig1.8 KB
assets/endpoint-security/example.remoteSite-meta.xmlconfig1.3 KB
assets/external-credentials/jwt-external-credential.externalCredential-meta.xmlconfig3.2 KB
assets/external-credentials/oauth-external-credential.externalCredential-meta.xmlconfig3.0 KB
assets/external-services/external-service-operations.mdmarkdown5.5 KB
assets/external-services/openapi-registration.externalServiceRegistration-meta.xmlconfig4.8 KB
assets/named-credentials/certificate-auth.namedCredential-meta.xmlconfig2.2 KB
assets/named-credentials/custom-auth.namedCredential-meta.xmlconfig2.2 KB
assets/named-credentials/oauth-client-credentials.namedCredential-meta.xmlconfig1.8 KB
assets/named-credentials/oauth-jwt-bearer.namedCredential-meta.xmlconfig2.2 KB
assets/platform-events/event-publisher.clsother6.4 KB
assets/platform-events/event-subscriber-action.clsother9.5 KB
assets/platform-events/event-subscriber-trigger.triggerother3.9 KB
assets/platform-events/platform-event-definition.object-meta.xmlconfig3.7 KB
assets/soap/soap-callout-service.clsother6.4 KB
assets/soap/wsdl2apex-guide.mdmarkdown6.2 KB
references/callout-patterns.mdmarkdown21.8 KB
references/cdc-guide.mdmarkdown8.2 KB
references/cli-reference.mdmarkdown2.9 KB
references/event-driven-architecture-guide.mdmarkdown10.1 KB
references/event-patterns.mdmarkdown27.2 KB
references/external-services-guide.mdmarkdown8.4 KB
references/messaging-api-v2.mdmarkdown17.9 KB
references/named-credentials-automation.mdmarkdown6.2 KB
references/named-credentials-guide.mdmarkdown7.1 KB
references/platform-events-guide.mdmarkdown6.6 KB
references/rest-callout-patterns.mdmarkdown8.8 KB
references/scoring-rubric.mdmarkdown2.4 KB
references/security-best-practices.mdmarkdown5.9 KB
scripts/README.mdmarkdown2.9 KB
scripts/configure-named-credential.shexecutablescript9.2 KB
scripts/set-api-credential.shexecutablescript4.9 KB
scripts/suggest_credential_setup.pyscript9.3 KB
scripts/templates/setup-credentials-with-csp.shexecutablescript5.9 KB
scripts/validate_integration.pyscript13.4 KB

scripts/templates/setup-credentials-with-csp.sh

View on GitHub
#!/bin/bash
#
# Setup Credentials Template with CSP Trusted Sites / Remote Site Settings
#
# TEMPLATE FOR CREATING NEW INTEGRATION SKILLS
#
# This template includes automatic deployment of endpoint security
# (CSP Trusted Sites or Remote Site Settings) along with credential configuration.
#
# How to use this template:
# 1. Copy to your skill: cp scripts/templates/setup-credentials-with-csp.sh my-skill/scripts/setup-credentials.sh
# 2. Replace all {{PLACEHOLDERS}} with your values
# 3. Create corresponding .cspTrustedSite-meta.xml and .remoteSite-meta.xml in assets/
# 4. Test with your API
#

set -e

# Colors
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
CYAN='\033[0;36m'
NC='\033[0m'

# Configuration - REPLACE THESE
SKILL_NAME="{{SkillName}}"              # e.g., "Bland.ai", "Stripe", "Twilio"
CUSTOM_SETTING_NAME="{{SettingName}}"  # e.g., "BlandAI", "StripeAPI", "TwilioAPI"
CSP_NAME="{{CSPName}}"                  # e.g., "BlandAPI", "StripeAPI", "TwilioAPI"
API_KEY_URL="{{APIKeyURL}}"             # e.g., "https://app.bland.ai/settings/api"

# Banner
echo -e "${CYAN}"
cat << EOF
╔══════════════════════════════════════════════════════════════╗
║                                                              ║
║        ${SKILL_NAME} Integration - Credential Setup              ║
║                                                              ║
╚══════════════════════════════════════════════════════════════╝
EOF
echo -e "${NC}"

# Usage
usage() {
    echo -e "${BLUE}Usage:${NC}"
    echo "  $0 <org-alias>"
    echo ""
    echo -e "${BLUE}Example:${NC}"
    echo "  $0 AIZoom"
    echo ""
    echo -e "${YELLOW}Get your ${SKILL_NAME} API key at:${NC}"
    echo -e "  ${CYAN}${API_KEY_URL}${NC}"
    exit 1
}

if [ $# -ne 1 ]; then
    echo -e "${RED}Error: Missing org alias${NC}"
    echo ""
    usage
fi

ORG_ALIAS=$1

# Validate sf CLI
if ! command -v sf &> /dev/null; then
    echo -e "${RED}Error: Salesforce CLI (sf) is not installed${NC}"
    exit 1
fi

# Validate org
echo -e "${BLUE}► Validating org connection...${NC}"
if ! sf org display --target-org "$ORG_ALIAS" &> /dev/null; then
    echo -e "${RED}✗ Cannot connect to org '$ORG_ALIAS'${NC}"
    exit 1
fi
echo -e "${GREEN}✓ Connected to org: $ORG_ALIAS${NC}"
echo ""

# Get API key
echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo -e "${YELLOW}Enter your ${SKILL_NAME} API key${NC}"
echo -e "${CYAN}Get it from: ${API_KEY_URL}${NC}"
echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo ""
echo -e "${BLUE}API Key (input hidden):${NC}"
read -s API_KEY
echo ""

if [ -z "$API_KEY" ]; then
    echo -e "${RED}Error: API key cannot be empty${NC}"
    exit 1
fi

echo -e "${GREEN}✓ API key received${NC}"
echo ""

# Configure Custom Setting (same logic as before)
echo -e "${BLUE}► Checking for API_Credentials__c Custom Setting...${NC}"
# ... [rest of Custom Setting logic - same as bland-ai-calls] ...

# Configure CSP Trusted Site / Remote Site Settings
echo -e "${BLUE}► Configuring endpoint security (CSP Trusted Sites)...${NC}"

CSP_CHECK=$(sf data query \
    --query "SELECT Id FROM CspTrustedSite WHERE DeveloperName = '${CSP_NAME}' LIMIT 1" \
    --target-org "$ORG_ALIAS" \
    --json 2>&1 || echo '{"status":1}')

if echo "$CSP_CHECK" | grep -q "sObject type 'CspTrustedSite' is not supported"; then
    # Fallback to Remote Site Settings
    echo -e "${YELLOW}⚠ CSP Trusted Sites not supported. Using Remote Site Settings...${NC}"

    REMOTE_SITE_CHECK=$(sf data query \
        --query "SELECT Id FROM RemoteSiteSetting WHERE SiteName = '${CSP_NAME}' LIMIT 1" \
        --target-org "$ORG_ALIAS" \
        --json 2>&1 || echo '{"status":1}')

    REMOTE_SITE_ID=$(echo "$REMOTE_SITE_CHECK" | jq -r '.result.records[0].Id // empty' 2>/dev/null)

    if [ -z "$REMOTE_SITE_ID" ]; then
        SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
        SKILL_DIR="$(dirname "$SCRIPT_DIR")"

        sf project deploy start \
            --source-dir "$SKILL_DIR/assets/${CSP_NAME}.remoteSite-meta.xml" \
            --target-org "$ORG_ALIAS" \
            --wait 5 > /dev/null 2>&1 || true

        echo -e "${GREEN}✓ Remote Site Setting configured${NC}"
    else
        echo -e "${GREEN}✓ Remote Site Setting already exists${NC}"
    fi
else
    CSP_ID=$(echo "$CSP_CHECK" | jq -r '.result.records[0].Id // empty' 2>/dev/null)

    if [ -z "$CSP_ID" ]; then
        SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
        SKILL_DIR="$(dirname "$SCRIPT_DIR")"

        sf project deploy start \
            --source-dir "$SKILL_DIR/assets/${CSP_NAME}.cspTrustedSite-meta.xml" \
            --target-org "$ORG_ALIAS" \
            --wait 5 > /dev/null 2>&1 || true

        echo -e "${GREEN}✓ CSP Trusted Site configured${NC}"
    else
        echo -e "${GREEN}✓ CSP Trusted Site already exists${NC}"
    fi
fi

echo ""
echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo -e "${GREEN}✓ ${SKILL_NAME} integration configured successfully!${NC}"
echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo ""

echo -e "${BLUE}🎉 Setup complete!${NC}"
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall