https://github.com/barrettotte/rpgle-twilio
RPGLE service program for sending text messages with Twilio SMS API
https://github.com/barrettotte/rpgle-twilio
ibmi ibmioss ile rpg rpgle twilio-api twilio-sms-api
Last synced: about 2 months ago
JSON representation
RPGLE service program for sending text messages with Twilio SMS API
- Host: GitHub
- URL: https://github.com/barrettotte/rpgle-twilio
- Owner: barrettotte
- License: mit
- Created: 2020-04-13T00:21:37.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2022-02-22T18:50:28.000Z (about 3 years ago)
- Last Synced: 2025-02-03T13:13:18.168Z (4 months ago)
- Topics: ibmi, ibmioss, ile, rpg, rpgle, twilio-api, twilio-sms-api
- Language: RPGLE
- Homepage:
- Size: 29.3 KB
- Stars: 4
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# RPGLE-Twilio-SMS
A really basic RPGLE service program to send a text with the Twilio SMS API.
This is my introduction to making service programs, so its probably not great.
Originally I was going to submit this to the [Twilio Hackathon at DEV](https://dev.to/t/twiliohackathon),
but I decided I would just keep this as a small learning project instead.
## Summary
The service program has two procedures, **sendSms** and **sendSmsVerbose**.
* **sendSms** accepts 'simple' parms and returns an error code.
* **sendSmsVerbose** accepts a request data structure and returns the response as a data structure.
Additionally, each procedure logs the Twilio request/response to [sql/sms_log.sql](sql/sms_log.sql).
The service program is really only a wrapper over top of a stored procedure I wrote, [sql/send_sms.sql](sql/send_sms.sql).
## Setup
* Setup Twilio account and a Twilio phone number - https://www.twilio.com/
* Connect to IBMi via SSH - ```ssh USER@YOUR400```
* Clone project - ```git clone https://github.com/barrettotte/RPGLE-Twilio.git```
* Navigate to project - ```cd RPGLE-Twilio```
* Give permissions to build script - ```chmod u+x build.sh```
* Run build script - ```./build.sh```
* The build script will create the following
* A Library named **TWILIO** to hold all of the Twilio objects
* A Log table for logging SMS requests - **sms_log**
* A simplified view over the log table -> **sms_log_v**
* A stored procedure to call Twilio SMS API -> **send_sms**
* An RPGLE service program to call Twilio SMS API -> ```ctl-opt bnddir('TWILIO/TWILIO') actgrp(*new);```
* Example call in [example/src/testtwilio.sqlrpgle](example/src/testtwilio.sqlrpgle)
## Commands
* give permissions to build script and build project - ```chmod u+x build.sh & ./build.sh```
* git push - ```git -c http.sslVerify=false push origin master```
## References
* [Twilio SMS docs](https://www.twilio.com/docs/sms)
* [Twilio SMS Python Quickstart](https://www.twilio.com/docs/sms/quickstart/python)
* [Read IFS files with RPG](https://www.rpgpgm.com/2016/01/read-ifs-file-using-rpg.html)
* [Writing and reading IFS files](https://github.com/worksofliam/blog/issues/12)