SuperAPI AI 工具集

twenty

编程与开发

查看项目

更新于 10-16 07:25

技能介绍

用途:该技能面向 Twenty CRM 的 API 操作,用于客户关系管理场景,例如查询、创建、更新和删除公司、联系人、商机、笔记与任务等记录。

主要能力:支持核心对象的增删改查,包括 /rest/companies、/rest/people、/rest/opportunities、/rest/notes、/rest/tasks、/rest/activities;支持元数据查询,如 /rest/metadata/objects、/rest/metadata/objects/{name}、/rest/metadata/picklists;并提供 /graphql 端点用于复杂关联查询。列表接口支持 limit、offset、filter、orderBy 等查询参数。

使用方式:请求需携带 Authorization: Bearer $TWENTY_TOKEN 头。示例:curl -s -X GET "https://api.twenty.com/rest/companies" --header "Authorization: Bearer $TWENTY_TOKEN"。创建记录时先写入 /tmp/twenty_request.json,再用 curl -s -X POST 提交,并设置 Content-Type: application/json。更新用 PATCH,删除用 DELETE。GraphQL 查询通过 POST /graphql 发送 query 字段。

适用场景:需要以编程方式管理 Twenty CRM 数据、批量查询或写入客户信息、读取对象结构以适配自定义对象、以及通过 GraphQL 处理带关系的复杂查询。

限制与排查:云端版本存在速率限制,自托管版本无限制。请求失败时可运行 zero doctor check-connector --env-name TWENTY_TOKEN 或 zero doctor check-connector --url https://api.twenty.com/rest/companies --method GET 排查。API 可在应用内 Settings → APIs & Webhooks 中测试,Webhooks 也在该处配置。自定义对象需通过元数据 API 发现结构。文档见 https://docs.twenty.com/developers/api-and-webhooks/api。