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 文档。如果成功，响应将通过键 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：通常可以省略，默认为创建时间。但如果您出于任何原因想要定义其他时间，此选项对您很有趣。