Another new feature for v5.0.2(1): Fax with SMS notification module

You don’t need patch2. Fax module is not part of a openemr release such as rel-5.0.2 but instead is a module that gets installed into openemr tree.

  • Now just install the patch I sent then goto the command prompt and get module with
    composer require openemr/oe-module-faxsms:1.2.0

  • Pay attention to results in terminal for errors or uninstal of existing module etc.

  • Then login to openemr and goto menu Modules-> Manage Modules Unregistered or Register tabs, depending.

  • Register, install and enable Fax SMS Module v1.2.0.

  • Log out then in and goto Modules-Fax Module to start.

If you’re still having issues then maybe easier to set up a phone call. I don’t charge for such things so no worries. I’m only interested with getting you guys up and running.

Thanks installed secseseful
Tomorrow will try to create an div account with RC, abd test how it’s works

Tried with Twilio credentials one more time before to move to RC.
Credentials not saving. Save button responding now, bot not saving.

check out this post and above in this topic.

Also, if save is not working it won’t matter if RC or twilio as both use this interface.

Thank you, I haven’t had a chance to try this out yet but will do it prior to the week ending

Feature for consideration:

There is evidence that texting can be effective for supporting smoking cessation efforts.

For smokers in the US there are some free services for that
https://smokefree.gov/tools-tips/text-programs
Which can be separated by target audience and language.

This meta-analysis “included 20 manuscripts with 22 interventions (N=15,593; 8128 (54%) women; mean age=29) from 10 countries”


There is some indication that mindfulness can also be a powerful tool in quitting tobacco products.


and meditation:

This paper explores studies the usage of mindfulness techniques to help smokers quit using SMS instead of an app that requires a data connection and you need a different version for iphone and android devices.


This may be helpful for patients with limited or no data plan but can receive text messages.

Some relevant info on the study
“The research team explained this to participants and asked them to imagine that Day 5 was their quit day (corresponding to week 5 of the intervention). Participants received 2 messages on Day 1, 3 on Day 2, 4 on Day 3, 5 on Day 4, 6 on Day 5, 4 on Day 6, and 3 on Day 7. In addition, participants could text CRAVE, STRESS, or SLIP at any point during the week to receive additional SMS text message support for coping with cravings, stress, or smoking lapses, respectively.”

" Mindfulness techniques incorporated into the 1-week period were mindful breathing, mindful eating, mindful stretching, and mindful awareness of body sensations (including experiences of craving). These are core practices of Mindfulness-Based Addiction Treatment for smoking cessation [17] and were adapted as brief, in-the-moment practices (eg, “Stand up and take a deep breath. Move your arms slowly in circles and then stretch your whole body from side to side, noticing how you feel”)."
Where [17] refers to: http://europepmc.org/article/MED/27213492

@sjpadgett have you looked into RapidPro at all? I believe it’s like a free version of twillio.
https://rapidpro.io/
https://community.rapidpro.io/about-rapidpro/

Hi @RachelEllison,
My first thought is that their environment is very foreign to ours. While it could be done, I fear it would be difficult to manage install etc…

However, this type of pattern is really a CAT http://www.healthmeasures.net/resource-center/measurement-science/computer-adaptive-tests-cats.

Currently we have easipro as part of v5.0.3 where the test are administered in the portal. I see no reason they can’t be sent to a mobile but, the portal is getting more mobile friendly everyday thanks @tywrenn .

Also i’m working now on FHIR adative questionnaires/responses that also interface with a couple ios/android client apps that administer tests.

Though I know purpose with rapidpro was free use, thought i’d point out what we are doing to hit the end results of such a pattern.

Thanks for sharing and I will look at closer to see how adaptive it is.

has anyone run into this error when running the composer require openemr/oe-module-faxsms:1.2.0 command

Problem 1
- adldap2/adldap2 v10.0.8 requires ext-ldap * → the requested PHP extension ldap is missing from your system.
- adldap2/adldap2 v10.0.8 requires ext-ldap * → the requested PHP extension ldap is missing from your system.
- adldap2/adldap2 v10.0.8 requires ext-ldap * → the requested PHP extension ldap is missing from your system.
- Installation request for adldap2/adldap2 10.0.8 → satisfiable by adldap2/adldap2[v10.0.8].

It’s not related to “openemr/oe-module-faxsms”
you should install the php extension “ext-ldap” in your server.

If you are not in production server you can try this command
composer require openemr/oe-module-faxsms:1.2.0 --ignore-platform-reqs in order to install the module.

Thank you, that allowed it to install

@sjpadgett
False alarm. Found issue. None issue. Everything working.
I want to add another fax service provider. What would it require? I did see in the thread where no other providers were being considered for adding to the list of fax service providers.

I have a new error since installing this feature. This occurs on all of my LBF forms.

Fatal error: Uncaught Error: Call to undefined function signer_head() in /var/www/html/openemr502/interface/forms/LBF/new.php:368 Stack trace: #0 /var/www/html/openemr502/interface/patient_file/encounter/load_form.php(18): include_once() #1 {main} thrown in /var/www/html/openemr502/interface/forms/LBF/new.php on line 368

Function did not get inserted into the options.inc.php file. Something simple.

I believe i entered incorrect credentials for my ring central because each time i open the fax module under modules i just get a repeating pop up window, is there somewhere in the code where i can go to remove the settings? The the window keeps popping up, i can’t remove it within the fax module

RC is an OAuth2 three legged authentication. Either log in with your account username/password or via google or other third party auth.

I am trying to use the twilio service. I have entered in all the configuration info. I get the below error message when I click send. Is there a specific port that faxes go out? I am using 5.0.2(1).
Is there documentation I can look over?

I am running 5.0.2(3). Successfully installed the service and configured it with twilio credentials, scheduled appointment for a certain time.
when i used the “test sms reminders”, i get the following error
* SEND NOTIFICATION BEFORE:1 | CRONJOB RUN EVERY:150 | APPDATETIME: 2020-07-30 17:00:00 | REMAINING APP HOUR:-4 | SEND ALERT AFTER:-5

  • INVALID Mobile Phone# 0803…4 SMS NOT SENT Patient: …
    ERROR: INVALID Mobile Phone# 0803…4 SMS NOT SENT For: …
    the above is without country code. when i add country code, i receive the same error as follows:
    * SEND NOTIFICATION BEFORE:1 | CRONJOB RUN EVERY:150 | APPDATETIME: 2020-07-30 17:00:00 | REMAINING APP HOUR:-4 | SEND ALERT AFTER:-5
  • INVALID Mobile Phone# +234803…4 SMS NOT SENT Patient: …
    ERROR: INVALID Mobile Phone# +234803…4 SMS NOT SENT For: …
    please what should i do to correct this.
    thank you

@sjpadgett @adunsulag
I am using CentOS 7.
I think my issue is that the tmp file is not being written to the system. When I drag and drop the file to the uploader. I don’t see a /tmp/send file created in the system /tmp folder. I am trying to track this down.
I think this is where my error lies in that the file is not there so the error pops up because it is missing.

I manually created the /tmp/send folder and the temp file is still not stored there.

I believe I immediately clean up tmp folder and good chance you won’t ever see it there.
When you send a fax the FaxServer handles the upload to Twilio by sending a api request to Twilio
where their server handshakes with fax server for security and streaming fax file.

Thats a REST api call so the folder needs to allow being redirected via htaccess.

Can you receive fax?

Sounds like mobile phone numbers are not correctly formatted. I don’t recall what I do for validation in cron script. I’ve never tested using any numbering outside of US so you may need to look into that in code.

Where does this handshake take place and can I test it to see if it is connecting?
Also, I can’t receive incoming fax. We just get a failed returned message.
We added the application hooks to the number. We need a way to test all the connections to find out where the system is failing for us. I think we are failing at the handshake for the outbound. I will be checking into the inbound with Twilio.

Look at your Debugger in Twilio dashboard. It will tell you what you need to know including the the requests header and responses. Very helpful.
Plus, you should receive an email from your Twilio account on first error of day plus every tenth error, I believe.
some things

  • on send, module sends a request to twilio with a callback to fax server to pick up file.
  • fax server then checks account credentials and computes a url/content validation to ensure the request comes from twilio.
  • then serves/streams the file back to twilio.
    Check your php error logs and see what fax server is complaining about.
  • in v1.2 I don’t check the production flag like v2 but you could patch out the validation for test purposes. L-31 interface/modules/custom_modules/oe-module-faxsms/controllers/FaxServer.php
  • the fax is placed in the server tmp dir $GLOBALS[‘temporary_files_dir’]/send/ until I stream it to twilio then it is unlinked. L-79

This should get you started debugging.