MKOCH's questions

Implementei o DocuSign no meu aplicativo Laravel e atualmente estou usando o JWT Grant Authentication para enviar documentos para clientes assinarem. A integração está funcionando bem, mas encontrei um problema: quando envio envelopes com documentos para clientes assinarem, inicialmente, tenho que fornecer consentimento manualmente por meio da página de consentimento do DocuSign.

Como meu aplicativo foi projetado para funcionar como um microsserviço de backend que envia documentos automaticamente por meio de gatilhos, esse processo de consentimento manual interrompe o fluxo. Gostaria de perguntar se há uma maneira de automatizar esse processo de consentimento, para que os documentos possam ser enviados sem a necessidade de intervenção manual.

Existe alguma configuração ou recurso de API que permita consentimento automático ou pré-autorização para o aplicativo, ou alguma prática recomendada sobre isso ao usar o DocuSign em tal serviço de backend?

Esta é minha classe de serviço cuidando da preparação e do envio dos envelopes.

 public function getToken(ApiClient $apiClient): string
    {
        try {
            $privateKey = file_get_contents(storage_path(env('DS_KEY_PATH')), true);
            $response = $apiClient->requestJWTUserToken(
                env('DS_CLIENT_ID'),
                env('DS_IMPERSONATED_USER_ID'),
                $privateKey,
                env('DS_JWT_SCOPE')
            );
            $token = $response[0];
            return $token->getAccessToken();
        } catch (\Throwable $th) {
            if (strpos($th->getMessage(), 'consent_required') !== false) {
                throw new \Exception('consent_required');
            }
            throw $th;
        }
    }

    /**
     * Build and return the consent URL
     *
     * @return string
     */
    public function getConsentUrl(): string
    {
        return "https://account-d.docusign.com/oauth/auth?response_type=code&scope=signature%20impersonation&client_id="
            . env('DS_CLIENT_ID')
            . "&redirect_uri=" . urlencode(env('DS_REDIRECT_URI'));
    }

    /**
     * Build the envelope definition from the request
     *
     * @param Request $request
     * @return EnvelopeDefinition
     */
    public function buildEnvelope(Request $request): EnvelopeDefinition
    {
        $fileContent = $request->file('formFile')->get();
        $fileName = $request->file('formFile')->getClientOriginalName();
        $fileExtension = $request->file('formFile')->getClientOriginalExtension();
        $recipientEmail = $request['email'];
        $recipientName = $request['name'];

        $document = new Document([
            'document_id' => "1",
            'document_base64' => base64_encode($fileContent),
            'file_extension' => $fileExtension,
            'name' => $fileName
        ]);

        $sign_here_tab = new SignHere([
            'anchor_string' => "FIRMA CLIENTE",
            'page_number' => "1",
            'anchor_units' => "pixels",
            'anchor_x_offset' => "40",
            'anchor_y_offset' => "40"
        ]);

        $tabs = new Tabs([
            'sign_here_tabs' => [$sign_here_tab]
        ]);

        $signer = new Signer([
            'email' => $recipientEmail,
            'name' => $recipientName,
            'recipient_id' => "1",
            'tabs' => $tabs
        ]);

        $recipients = new Recipients([
            'signers' => [$signer]
        ]);

        $inlineTemplate = new InlineTemplate([
            'recipients' => $recipients,
            'sequence' => "1"
        ]);

        $compositeTemplate = new CompositeTemplate([
            'composite_template_id' => "1",
            'document' => $document,
            'inline_templates' => [$inlineTemplate]
        ]);

        return new EnvelopeDefinition([
            'composite_templates' => [$compositeTemplate],
            'email_subject' => "Please sign",
            'status' => "sent"
        ]);
    }

    /**
     * Send the envelope using the DocuSign API
     *
     * @param ApiClient $apiClient
     * @param string $accountId
     * @param EnvelopeDefinition $envelopeDefinition
     * @return object
     */
    public function sendEnvelope(ApiClient $apiClient, string $accountId, EnvelopeDefinition $envelopeDefinition): object
    {
        $envelopeApi = new EnvelopesApi($apiClient);
        return $envelopeApi->createEnvelope($accountId, $envelopeDefinition);
    }

Estou trabalhando em um aplicativo Laravel onde integrei o DocuSign para enviar documentos para assinaturas eletrônicas. Segui a documentação oficial da API do DocuSign para configurar a autenticação JWT e enviar documentos com sucesso. No entanto, quando envio um documento para assinatura, o campo de assinatura não aparece no documento.

Como mencionei, enviei os documentos com sucesso e o código para construção do envelope é o seguinte:

    public function buildEnvelope(Request $request): EnvelopeDefinition
    {
        $fileContent = $request->file('formFile')->get();
        $fileName = $request->file('formFile')->getClientOriginalName();
        $fileExtension = $request->file('formFile')->getClientOriginalExtension();
        $recipientEmail = $request['email'];
        $recipientName = $request['name'];

        $document = new Document([
            'document_id' => "1",
            'document_base64' => base64_encode($fileContent),
            'file_extension' => $fileExtension,
            'name' => $fileName
        ]);

        $sign_here_tab = new SignHere([
            'anchor_string' => "**signature**",
            'page_number' => "1",
            'anchor_units' => "pixels",
            'anchor_x_offset' => "100",
            'anchor_y_offset' => "300"
        ]);

        $tabs = new Tabs([
            'sign_here_tabs' => [$sign_here_tab]
        ]);

        $signer = new Signer([
            'email' => $recipientEmail,
            'name' => $recipientName,
            'recipient_id' => "1",
            'tabs' => $tabs
        ]);

        $recipients = new Recipients([
            'signers' => [$signer]
        ]);

        $inlineTemplate = new InlineTemplate([
            'recipients' => $recipients,
            'sequence' => "1"
        ]);

        $compositeTemplate = new CompositeTemplate([
            'composite_template_id' => "1",
            'document' => $document,
            'inline_templates' => [$inlineTemplate]
        ]);

        return new EnvelopeDefinition([
            'composite_templates' => [$compositeTemplate],
            'email_subject' => "Please sign",
            'status' => "sent"
        ]);
    }

Especifiquei o número da página, algumas coordenadas aleatórias, string de âncora e unidades de âncora e esperava que na página 1 em algum lugar eu visse a assinatura do texto