aboutsummaryrefslogtreecommitdiff
path: root/libraries/Bridge/examples/Temboo/SendAnEmail/SendAnEmail.ino
diff options
context:
space:
mode:
Diffstat (limited to 'libraries/Bridge/examples/Temboo/SendAnEmail/SendAnEmail.ino')
-rw-r--r--libraries/Bridge/examples/Temboo/SendAnEmail/SendAnEmail.ino147
1 files changed, 147 insertions, 0 deletions
diff --git a/libraries/Bridge/examples/Temboo/SendAnEmail/SendAnEmail.ino b/libraries/Bridge/examples/Temboo/SendAnEmail/SendAnEmail.ino
new file mode 100644
index 0000000..76fdc1d
--- /dev/null
+++ b/libraries/Bridge/examples/Temboo/SendAnEmail/SendAnEmail.ino
@@ -0,0 +1,147 @@
+/*
+ SendAnEmail
+
+ Demonstrates sending an email via a Google Gmail account using the Temboo Arduino Yun SDK.
+
+ Check out the latest Arduino & Temboo examples and support docs at http://www.temboo.com/arduino
+
+ A Temboo account and application key are necessary to run all Temboo examples.
+ If you don't already have one, you can register for a free Temboo account at
+ http://www.temboo.com
+
+ Since this sketch uses Gmail to send the email, you'll also need a valid
+ Google Gmail account. The sketch needs the username and password you use
+ to log into your Gmail account: substitute the placeholders below for these values.
+
+ This example assumes basic familiarity with Arduino sketches, and that your Yun is connected
+ to the Internet.
+
+ Looking for another API? We've got over 100 in our Library!
+
+ This example code is in the public domain.
+*/
+
+#include <Bridge.h>
+#include <Console.h>
+#include <FileIO.h>
+#include <HttpClient.h>
+#include <Process.h>
+#include "TembooAccount.h" // contains Temboo account information
+ // as described in the footer comment below
+
+/*** SUBSTITUTE YOUR VALUES BELOW: ***/
+
+// your Gmail address, eg "bob.smith@gmail.com"
+const String GMAIL_USER_NAME = "xxxxxxxxxx";
+
+// your Gmail password
+const String GMAIL_PASSWORD = "xxxxxxxxxx";
+
+// the email address you want to send the email to, eg "jane.doe@temboo.com"
+const String TO_EMAIL_ADDRESS = "xxxxxxxxxx";
+
+
+boolean success = false; // a flag to indicate whether we've sent the email yet or not
+
+void setup() {
+ Serial.begin(9600);
+
+ // for debugging, wait until a serial console is connected
+ delay(4000);
+ while(!Serial);
+
+ Bridge.begin();
+}
+
+void loop()
+{
+ // only try to send the email if we haven't already sent it successfully
+ if (!success) {
+
+ Serial.println("Running SendAnEmail...");
+
+ // we need a Process object to send a Choreo request to Temboo
+ Process SendEmailChoreo;
+
+ // invoke the Temboo client
+ SendEmailChoreo.begin("temboo");
+
+ // set Temboo account credentials
+ SendEmailChoreo.addParameter("-a");
+ SendEmailChoreo.addParameter(TEMBOO_ACCOUNT);
+ SendEmailChoreo.addParameter("-u");
+ SendEmailChoreo.addParameter(TEMBOO_APP_KEY_NAME);
+ SendEmailChoreo.addParameter("-p");
+ SendEmailChoreo.addParameter(TEMBOO_APP_KEY);
+
+ // identify the Temboo Library choreo to run (Google > Gmail > SendEmail)
+ SendEmailChoreo.addParameter("-c");
+ SendEmailChoreo.addParameter("/Library/Google/Gmail/SendEmail");
+
+ // set the required choreo inputs
+ // see https://www.temboo.com/library/Library/Google/Gmail/SendEmail/
+ // for complete details about the inputs for this Choreo
+
+ // the first input is a your Gmail user name.
+ SendEmailChoreo.addParameter("-i");
+ SendEmailChoreo.addParameter("Username:" + GMAIL_USER_NAME);
+
+ // next is your Gmail password.
+ SendEmailChoreo.addParameter("-i");
+ SendEmailChoreo.addParameter("Password:" + GMAIL_PASSWORD);
+
+ // who to send the email to
+ SendEmailChoreo.addParameter("-i");
+ SendEmailChoreo.addParameter("ToAddress:" + TO_EMAIL_ADDRESS);
+
+ // then a subject line
+ SendEmailChoreo.addParameter("-i");
+ SendEmailChoreo.addParameter("Subject:ALERT: Greenhouse Temperature");
+
+ // next comes the message body, the main content of the email
+ SendEmailChoreo.addParameter("-i");
+ SendEmailChoreo.addParameter("MessageBody:Hey! The greenhouse is too cold!");
+
+ // tell the Process to run and wait for the results. The
+ // return code (rc) will tell us whether the Temboo client
+ // was able to send our request to the Temboo servers
+ unsigned int rc = SendEmailChoreo.run();
+
+ // a return code of zero (0) means everything worked
+ if (rc == 0) {
+ Serial.println("Success! Email sent!");
+ success = true;
+ } else {
+ // a non-zero return code means there was an error
+ // read and print the error message
+ while (SendEmailChoreo.available()) {
+ Serial.print((char)SendEmailChoreo.read());
+ }
+ }
+ SendEmailChoreo.close();
+
+ // do nothing for the next 60 seconds
+ delay(60000);
+ }
+}
+
+/*
+ IMPORTANT NOTE: TembooAccount.h:
+
+ TembooAccount.h is a file referenced by this sketch that contains your Temboo account information.
+ You need to create this file. To do so, make a new tab in Arduino, call it TembooAccount.h, and
+ include the following variables and constants:
+
+ #define TEMBOO_ACCOUNT "myTembooAccountName" // your Temboo account name
+ #define TEMBOO_APP_KEY_NAME "myFirstApp" // your Temboo app key name
+ #define TEMBOO_APP_KEY "xxx-xxx-xxx-xx-xxx" // your Temboo app key
+
+ The same TembooAccount.h file settings can be used for all Temboo SDK sketches.
+
+ You can find your Temboo App Key information on the Temboo website,
+ under My Account > Application Keys
+
+ Keeping your account information in a separate file means you can save it once,
+ then just distribute the main .ino file without worrying that you forgot to delete your credentials.
+*/
+