pm-babelforce

name	pm-babelforce
description	Babelforce connector knowledge and safe action guide.

pm-babelforce

Purpose

Reads Babelforce call reporting, recordings, numbers, and users through the Babelforce v2 REST API. In architecture v2 this quarantine bundle dispatches live reads through a Tier-2 hook that delegates to the legacy connector until the wave 6 cutover.

Icon

• asset: icons/babelforce.svg
• source: upstream_registry
• review_status: upstream_seeded
• review_url: https://api.babelforce.com/

Capabilities

• check=true catalog=true read=true write=false query=false
• Integration type: api

Authentication

• Use pm credentials add with --from-env or --value-stdin for secret fields.

Configuration

• base_url
• date_created_from
• date_created_to
• mode
• region
• access_key_id (secret)
• access_token (secret)

ETL Streams

• calls:
  • primary key: id
  • cursor: dateCreated
  • fields: anonymous(), conversationId(), dateCreated(), dateEstablished(), dateFinished(), domain(), duration(), finishReason(), from(), id(), lastUpdated(), parentId(), sessionId(), source(), state(), to(), type()
• calls_extended:
  • primary key: id
  • cursor: dateCreated
  • fields: anonymous(), conversationId(), dateCreated(), dateEstablished(), dateFinished(), domain(), duration(), finishReason(), from(), id(), lastUpdated(), parentId(), sessionId(), source(), state(), to(), type()
• recordings:
  • primary key: id
  • cursor: dateCreated
  • fields: dateCreated(), duration(), id(), lastUpdated(), state(), url()
• numbers:
  • primary key: id
  • cursor: dateCreated
  • fields: dateCreated(), id(), lastUpdated(), name(), number(), state()
• users:
  • primary key: id
  • cursor: dateCreated
  • fields: dateCreated(), id(), lastUpdated(), name(), number(), state()

Sync Modes

• ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped, incremental_append, incremental_append_deduped

Security

• read risk: external Babelforce API reads performed by the legacy connector via a Tier-2 hook
• write risk: unsupported
• approval: none; read-only
• Never pass secret values in chat, shell arguments, logs, docs, or JSON output.

Commands

Inspect as a manual

pm connectors inspect babelforce

Inspect as structured JSON

pm connectors inspect babelforce --json

Agent Rules

• Run pm connectors inspect babelforce before creating credentials or plans.
• Use --json only when the caller needs structured output; use the manual for human-readable guidance.
• Never ask the user to paste secret values into chat.