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.ino137
1 files changed, 137 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..4f841f8
--- /dev/null
+++ b/libraries/Bridge/examples/Temboo/SendAnEmail/SendAnEmail.ino
@@ -0,0 +1,137 @@
+/*
+ SendAnEmail
+
+ Demonstrates sending an email via a Google Gmail account using Temboo from an Arduino Yun.
+
+ 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 to use with your Arduino Yun? We've got over 100 in our Library!
+
+ This example code is in the public domain.
+*/
+
+#include <Bridge.h>
+#include <Temboo.h>
+#include "TembooAccount.h" // contains Temboo account information
+ // as described in the footer comment below
+
+/*** SUBSTITUTE YOUR VALUES BELOW: ***/
+
+// Note that for additional security and reusability, you could
+// use #define statements to specify these values in a .h file.
+
+// your Gmail username, formatted as a complete email 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";
+
+// a flag to indicate whether we've tried to send the email yet or not
+boolean attempted = false;
+
+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 tried
+ if (!attempted) {
+
+ Serial.println("Running SendAnEmail...");
+
+ TembooChoreo SendEmailChoreo;
+
+ // invoke the Temboo client
+ // NOTE that the client must be reinvoked, and repopulated with
+ // appropriate arguments, each time its run() method is called.
+ SendEmailChoreo.begin();
+
+ // set Temboo account credentials
+ SendEmailChoreo.setAccountName(TEMBOO_ACCOUNT);
+ SendEmailChoreo.setAppKeyName(TEMBOO_APP_KEY_NAME);
+ SendEmailChoreo.setAppKey(TEMBOO_APP_KEY);
+
+ // identify the Temboo Library choreo to run (Google > Gmail > SendEmail)
+ SendEmailChoreo.setChoreo("/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 your Gmail email address.
+ SendEmailChoreo.addInput("Username", GMAIL_USER_NAME);
+ // next is your Gmail password.
+ SendEmailChoreo.addInput("Password", GMAIL_PASSWORD);
+ // who to send the email to
+ SendEmailChoreo.addInput("ToAddress", TO_EMAIL_ADDRESS);
+ // then a subject line
+ SendEmailChoreo.addInput("Subject", "ALERT: Greenhouse Temperature");
+
+ // next comes the message body, the main content of the email
+ SendEmailChoreo.addInput("MessageBody", "Hey! The greenhouse is too cold!");
+
+ // tell the Choreo to run and wait for the results. The
+ // return code (returnCode) will tell us whether the Temboo client
+ // was able to send our request to the Temboo servers
+ unsigned int returnCode = SendEmailChoreo.run();
+
+ // a return code of zero (0) means everything worked
+ if (returnCode == 0) {
+ Serial.println("Success! Email sent!");
+ } else {
+ // a non-zero return code means there was an error
+ // read and print the error message
+ while (SendEmailChoreo.available()) {
+ char c = SendEmailChoreo.read();
+ Serial.print(c);
+ }
+ }
+ SendEmailChoreo.close();
+
+ // set the flag showing we've tried
+ attempted = true;
+ }
+}
+
+/*
+ IMPORTANT NOTE: TembooAccount.h:
+
+ TembooAccount.h is a file referenced by this sketch that contains your Temboo account information.
+ You'll need to edit the placeholder version of TembooAccount.h included with this example sketch,
+ by inserting your own Temboo account name and app key information. The contents of the file should
+ look like:
+
+ #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
+
+ You can find your Temboo App Key information on the Temboo website,
+ under My Account > Application Keys
+
+ The same TembooAccount.h file settings can be used for all Temboo SDK sketches.
+
+ Keeping your account information in a separate file means you can share the main .ino file without worrying
+ that you forgot to delete your credentials.
+*/