docusignapi - 複数の電子メール アドレスを templateRoles の 1 つの配列に渡す

Question

コンマで区切られた電子メール アドレスのリストを templateRoles の email 要素に渡すことはできますか?つまり、"email" => $to ($to はコンマで区切られた電子メールのリストです)? それとも、各受信者を独自の配列で個別に指定する必要がありますか?

Answer 1

各受信者は、独自の配列で指定する必要があります。DocuSign プラットフォームは、name、email、recipientId (埋め込み機能を使用している場合はclientUserIdも) の組み合わせによって受信者を識別します。そのため、特定の受信者の電子メール プロパティに由来するカンマ区切りのリストを作成することはできません。

たとえば、JSON 形式のリクエスト本文を使用すると、通常、受信者は次のようになります。

"recipients": {
    "signers": [
        {
            "email": "firstemail@gmail.com",
            "name": "First Recipient",
            "recipientId": "1",
            "routingOrder": "1",
            "tabs": {
                "signHereTabs": [
                    {
                        "xPosition": "100",
                        "yPosition": "100",
                        "documentId": "1",
                        "pageNumber": "1"
                    }
                ]
            }
        },
        {
            "email": "secondemail@gmail.com",
            "name": "Second Recipient",
            "recipientId": "2",
            "routingOrder": "2",
            "tabs": {
                "initialHereTabs": [
                    {
                        "xPosition": "100",
                        "yPosition": "200",
                        "documentId": "1",
                        "pageNumber": "1"
                    }
                ],
                "signHereTabs": [
                    {
                        "xPosition": "200",
                        "yPosition": "200",
                        "documentId": "1",
                        "pageNumber": "1"
                    }
                ]
            }
        }
    ],
    "carbonCopies": [
        {
            "email": "thirdemail@gmail.com",
            "name": "Third Recipient",
            "recipientId": "3",
            "routingOrder": "3"
        },
        {
            "email": "forthemail@gmail.com",
            "name": "Forth Email",
            "recipientId": "4",
            "routingOrder": "3"
        }
    ]
}

上記の JSON は、特定のエンベロープに 4 人の受信者を追加します。2 人の署名受信者 (1 人は 1 つの signHere タブを持ち、もう 1 人は signHere タブと initialHere タブを持ちます) と 2 人のカーボン コピー (CC) 受信者です。