Question

Configuring a custom cover page

  • 30 June 2020
  • 3 replies
  • 1987 views

Fax can be send with cover pages, but we want to customize the default cover page by adding images, logo, text with fonts and colors.

How can we override the default page setting in fax and implement a custom cover page?


3 replies

"The RingCentral API supports over 10 different fax cover page templates "

Please check this example: https://github.com/grokify/ringcentral-demos-fax-cover-page

HI,

@Anirban Sen Chowdhary,
I have a sandbox account .I am using Java SDK for sending Fax. Whenever i try providing my own custom cover page file in .docx. My Sending Fax Fails. If i remove coverPage by setting it to '0' it also fails.
Only Successfully sent when i go with Default Fax Page.


I am using Below Code to send Fax.

CreateFaxMessageRequest postParameters = new CreateFaxMessageRequest();
        MessageStoreCalleeInfoRequest[] recivingNumbers = new MessageStoreCalleeInfoRequest[updateMessage
                .getReceiverNumber().size()];
        for(int i=0;i<updateMessage.getReceiverNumber().size();i++) {
            recivingNumbers[i] = new MessageStoreCalleeInfoRequest()
                    .phoneNumber(updateMessage.getReceiverNumber().get(i));
        }
        
        postParameters.to = recivingNumbers;
        postParameters.faxResolution = "High";
        postParameters.coverPageText = StringUtils.isNotBlank(updateMessage.getContent()) ? updateMessage.getContent():"" ;
        
        if(!updateMessage.getFaxFileIds().isEmpty()) {
            List<Attachment> attachments = new ArrayList<>();
            if(Objects.nonNull(updateMessage.getFaxCoverPageId())) {
                FaxAttachment  coverPage = this.queueMessageService.getFaxFileAttachment(updateMessage.getFaxCoverPageId());
                postParameters.coverIndex = 0L; 
                Attachment coverPageObj = new Attachment(); 
                coverPageObj.bytes(coverPage.getData());
                coverPageObj.contentType(coverPage.getContentType());
                coverPageObj.fileName(coverPage.getFileName()); 
                attachments.add(coverPageObj);
            } 
            for(ObjectId id:updateMessage.getFaxFileIds()) {
                FaxAttachment  fileAttachment = this.queueMessageService.getFaxFileAttachment(id);
                Attachment attachmentPageObj = new Attachment(); 
                attachmentPageObj.bytes(fileAttachment.getData());
                attachmentPageObj.contentType(fileAttachment.getContentType());
                attachmentPageObj.fileName(fileAttachment.getFileName()); 
                attachments.add(attachmentPageObj);
            }
            
            Attachment[] attachmentsArr = attachments.stream().toArray(Attachment[]::new);
            postParameters.attachments = attachmentsArr;
        }
        
        FaxResponse response = restClient.restapi().account().extension().fax().post(postParameters);
        

Also is there any limitation on Number of Pages in fax for SandBox Account; currently fax with only 2 pages is getting successfully sent.
Image of my custom .docx cover page is as below.

but they still dont have "page count" field on custom coverpages. smh.

Reply