Twenty CRM 技能用于与自托管的 Twenty CRM 实例交互,支持通过 REST 和 GraphQL 两种方式访问数据。
用途
该技能面向已在自有环境中部署 Twenty CRM 的用户,用于以脚本方式对公司等业务对象进行查询和增删改操作,适合需要将 CRM 数据操作接入自动化流程的场景。
配置
需要创建 config/twenty.env 文件(示例见 config/twenty.env.example),其中包含:
TWENTY_BASE_URL,例如 https://crm.example.com 或 http://localhost:3000;
TWENTY_API_KEY,即 Bearer token。
脚本会自动加载该配置文件。
主要能力
技能提供底层助手脚本,支持发送 REST GET、POST、PATCH、DELETE 请求,以及执行 GraphQL 查询。例如:
REST GET:skills/twenty-crm/scripts/twenty-rest-get.sh "/companies" 'filter={"name":{"ilike":"%acme%"}}&limit=10'
REST POST:skills/twenty-crm/scripts/twenty-rest-post.sh "/companies" '{"name":"Acme"}'
REST PATCH:skills/twenty-crm/scripts/twenty-rest-patch.sh "/companies/<id>" '{"employees":550}'
REST DELETE:skills/twenty-crm/scripts/twenty-rest-delete.sh "/companies/<id>"
GraphQL:skills/twenty-crm/scripts/twenty-graphql.sh 'query { companies(limit: 5) { totalCount } }'
此外还提供常用对象操作示例,如创建公司:skills/twenty-crm/scripts/twenty-create-company.sh "Acme" "acme.com" 500;按名称查找公司:skills/twenty-crm/scripts/twenty-find-companies.sh "acme" 10。
使用方式
在完成 twenty.env 配置后,直接调用对应脚本并传入端点、查询或数据体即可;对象名称和端点可能因工作区元数据和 Twenty 版本不同而变化。
限制
Twenty 同时支持 REST(/rest/...)和 GraphQL(/graphql)路径。对象名称与端点取决于具体工作区的元数据以及 Twenty 版本,可能不一致。认证令牌在某些部署中有效期较短,若返回 401 需要刷新令牌。关于收费、价格、平台支持范围等信息,资料中暂未提供。