README

此包允许您将 Neos 表单中的数据发送到 Pipedrive CRM，从而可以从用户提交的数据中创建个人、组织或交易。

安装

composer require --no-update gmedia/pipedrivefinisher

如果您使用新的基于 NodeType 的表单构建器，您可能还想添加基于 NodeType 的完成器

composer require --no-update gmedia/pipedrivefinisher-nodetypes

在您的 composer.json 中添加需求后，您可以更新您的 composer.lock 并安装插件。

composer update

配置

为了能够将数据发送到您的 Pipedrive 账户，您需要在配置文件中定义您的公司域名和 API 令牌。

Gmedia:
  PipedriveFinisher:
    Api:
      Domain: ''
      Token: ''

完成器

有关可用选项的更多信息，请参阅 官方 Pipedrive 文档。如果成功，则响应将通过 key Pipedrive.{FINISHER} 返回到表单上下文，例如 Pipedrive.OrganizationFinisher，这将使您能够使用 ID。例如，您可以先创建一个组织，然后使用该 ID 来联系组织中的个人。

有关如何使用所有完成器的完整堆栈示例，请参阅 此处。

组织

finisher:  
  -
    identifier: 'Gmedia.PipedriveFinisher:OrganizationFinisher'
    options:
      name: ''
      owner_id: ''
      visible_to: ''
      add_time: ''

个人

finisher:  
  -
    identifier: 'Gmedia.PipedriveFinisher:PersonFinisher'
    options:
      name: ''
      owner_id: ''
      org_id: ''
      email: ''
      phone: ''
      visible_to: ''
      add_time: ''

交易

finisher:  
  -
    identifier: 'Gmedia.PipedriveFinisher:DealFinisher'
    options:
      title: "{name}'s Deal'"
      value: ''
      currency: ''
      user_id: ''
      person_id: "{Pipedrive.PersonFinisher.ID}"
      org_id: "{Pipedrive.OrganizationFinisher.ID}"
      stage_id: ''
      status: ''
      probability: ''
      lost_reason: ''
      add_time: ''
      visible_to: ''

备注

finisher:  
  -
    identifier: 'Gmedia.PipedriveFinisher:NoteFinisher'
    options:
      content: ''
      person_id: ''
      org_id: ''
      deal_id: ''
      add_time: ''
      pinned_to_deal_flag: ''
      pinned_to_organization_flag: ''
      pinned_to_person_flag: ''

活动

finisher:
  -
    identifier: 'Gmedia.PipedriveFinisher:ActivityFinisher'
    options:
      subject: ''
      done: false
      type: ''
      due_date: ''
      duration: ''
      user_id: ''
      deal_id: ''
      person_id: ''
      participants: ''
      org_id: ''
      note: ''

通用选项

每个实体上出现的选项说明

• owner_id：标记为所有者的 Pipedrive 用户 ID。通常应该留空，然后将与 API 令牌关联的用户自动设置。
• visible_to：定义谁可以查看条目。代码 1 将条目仅提供给所有者和追随者，代码 3 将将其提供给整个公司。
• add_time：通常可以留空，默认为创建时间。但如果您出于任何原因想要定义另一个时间，此选项对您很有趣。