question

kraig-qin3183 avatar image
kraig-qin3183 asked Leonard leWang Deactivated edited

online fax customize cover sheet.

The fax In production right now, and already set up real account number with my website, so when someone submit the order, the website will automatic send fax to a real line. The problem is can't customize cover sheet, the frist page is look like unprofessional, and waste too much paper, because the note is on the second pages. So we need the company logo and note on the frist page, that's will save too much paper. The attached file picture 1 is currently situation as you can see, and the picture 2 is what i am want. Could you please help to solve this problem, and what kind of information you need, please let me know, thanks very much!




app administration
1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

Tyler Liu avatar image
Tyler Liu answered orchard-medical-center commented
It is possible to customize fax cover page. Please take this as example:  https://github.com/grokify/ringcentral-demos-fax-cover-page
7 comments
1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

vyshakhbabji avatar image vyshakhbabji ♦♦ commented ·
Here is the Java sample code for sending fax  :  https://github.com/vyshakhbabji/ringcentral-java/blob/master/src/utils/SendFax.java#L48

For disabling the cover page : 

Disable coverPage   by making the body 

(line : 
payload = { to: [{ phoneNumber: config.RC_DEMO_FAX_TO }],
                     faxResolution: 'High',
                      coverIndex: 0
            };
For adding cover page:  

Add your own custom cover page as your firattachmentent as mentioned above by Tyler. 

for example like this: 

RequestBody requestBody = new MultipartBuilder().type(MultipartBuilder.MIXED).addPart(body)    .addFormDataPart("cover", file.getName(), RequestBody.create(faxContentType, file)).addFormDataPart("attachment1", file.getName(), RequestBody.create(faxContentType,file)).build();
1 Like 1 ·
kraig-qin3183 avatar image kraig-qin3183 commented ·
Thanks for your quick response. I saw there customize cover sheet, but how to add the company logo on the file, could you please give me some of technique support, and I am ready with DOC cover sheet. Because we just need one page for each fax, so please help us, thanks very much!
0 Likes 0 ·
Tyler Liu avatar image Tyler Liu ♦ commented ·
Which programming language are you using? Maybe I can provide your with some sample code. Basically you need to specify coverIndex = 0 :  https://github.com/grokify/ringcentral-demos-fax-cover-page/blob/master/nodejs/index.js#L23  Then the first file attachment will be used as cover. You can use a doc file as cover.
0 Likes 0 ·
kraig-qin3183 avatar image kraig-qin3183 commented ·
Hi, I just contacted with my engineer, they use the JAVA language, JDK 1.8, the server system is ubuntun 14.04, and web are Tomcat 9. So do you need I upload my cover sheet and help me get the code? Because my engineer are Chinese, so some of they not able to get this instration. Please help me! Thanks very much.
0 Likes 0 ·
Tyler Liu avatar image Tyler Liu ♦ commented ·
From your original message I can see that your engineers already got the fax sending working (without customized cover page). What they need to do is just do a minor change to their code to specify a custom cover page. I am not an export on Java SDK but if I see the code I can figure out how to adjust it.

Please let your Chinese engineers contact me via QQ 252261703.  I will assist them to get it done.
0 Likes 0 ·
John Wang avatar image John Wang ♦♦ commented ·
You can add a custom logo by simply using an image tag like the following: <img src=" http://path.to/my/logo.png" /> tag.

In the demos available at:  https://github.com/grokify/ringcentral-demos-fax-cover-page

You can use the following handlebars HTML template as an example: 

https://github.com/grokify/ringcentral-demos-fax-cover-page/blob/master/ruby/view_coverpage_logo.handlebars#L19
0 Likes 0 ·
orchard-medical-center avatar image orchard-medical-center commented ·
Hello Tyler,

You offered some sample code in your post. We have several medical clinics which require a privacy notice on the fax cover sheet. Can you provide some sample code in VBA for me to customize the cover sheet?

Thank you
0 Likes 0 ·
ALI IMRAAN avatar image
ALI IMRAAN answered ALI IMRAAN edited

@Tyler Liu

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 Sand Box Account? Currently fax with only 2 pages is getting successfully sent.
Image of my .docx file is as below


1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

Developer sandbox tools

Using the RingCentral Phone for Desktop, you can dial or receive test calls, send and receive test SMS or Fax messages in your sandbox environment.

Download RingCentral Phone for Desktop:

Tip: switch to the "sandbox mode" before logging in the app:

  • On MacOS: press "fn + command + f2" keys
  • On Windows: press "Ctrl + F2" keys