Simulate Alexa Skill with Amazon Alexa API on Weather for ZIP Code from HERE API

Pipedream makes it easy to connect APIs for Amazon Alexa, HERE and 2,700+ other apps remarkably fast.

Trigger workflow on

Weather for ZIP Code from the HERE API

Next, do this

Simulate Alexa Skill with the Amazon Alexa API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a HERE trigger and Amazon Alexa action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the Weather for ZIP Code trigger
1. Connect your HERE account
2. Configure ZIP code
3. Configure timer
Configure the Simulate Alexa Skill action
1. Connect your Amazon Alexa account
2. Configure Skill ID
3. Select a Stage
4. Configure Input Content
5. Select a Device Locale
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger#

Weather for ZIP Code on HERE

Description:Emits the weather report for a specific ZIP code on a schedule

Version:0.0.3

Key:here-weather-for-zip

View on GitHub

HERE Overview#

The HERE API provides a suite of location-based services including maps, geocoding, places, routing, and traffic. With Pipedream, you can automate workflows that require real-time location intelligence. For instance, enhance logistics with dynamic routing, personalize customer interactions with geolocation data, or monitor assets by integrating location updates into your systems.

Trigger Code#

const here = require("../../here.app.js");
const { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } = require("@pipedream/platform");

module.exports = {
  name: "Weather for ZIP Code",
  version: "0.0.3",
  key: "here-weather-for-zip",
  description: "Emits the weather report for a specific ZIP code on a schedule",
  type: "source",
  props: {
    here,
    zipCode: {
      propDefinition: [
        here,
        "zipCode",
      ],
    },
    timer: {
      type: "$.interface.timer",
      default: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
  },
  async run() {
    const report = await this.here.returnReportForZIP(this.zipCode);
    this.$emit(report, {
      summary: `Weather report for ${this.zipCode} at ${report.feedCreation}`,
      ts: Date.now(),
    });
  },
};

Trigger Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
HERE	`here`	`app`	This component uses the HERE app.
ZIP code	`zipCode`	`integer`	The ZIP code you'd like to pull weather stats for (only supported for locations in the United States)
	`timer`	`$.interface.timer`

Trigger Authentication#

HERE uses API keys for authentication. When you connect your HERE account, Pipedream securely stores the keys so you can easily authenticate to HERE APIs in both code and no-code steps.

Sign up for a HERE account, then create a new application and associated API key — see the HERE Authentication Docs for step-by-step instructions.

Enter your API key below.

About HERE#

Build location-aware apps and services using the world’s #1 location platform

Action#

Simulate Alexa Skill on Amazon Alexa

Description:Simulate a dialog from an Alexa-enabled device and receive the skill response for the specified example utterance. [See the documentation](https://developer.amazon.com/en-us/docs/alexa/smapi/skill-simulation-api.html)

Version:0.0.1

Key:amazon_alexa-simulate-skill

View on GitHub

Amazon Alexa Overview#

The Amazon Alexa API connects your Pipedream workflows to Alexa's smart capabilities, enabling you to build voice-driven interactions and extend the functionality of Alexa Skills. Interact with users through their Alexa devices, manage and update Skills, or harness Alexa's smart home control. With Pipedream's serverless platform, you can create complex workflows that respond to Alexa events, trigger actions in other services, or process voice commands for custom outcomes.

Action Code#

import app from "../../amazon_alexa.app.mjs";

export default {
  key: "amazon_alexa-simulate-skill",
  name: "Simulate Alexa Skill",
  description: "Simulate a dialog from an Alexa-enabled device and receive the skill response for the specified example utterance. [See the documentation](https://developer.amazon.com/en-us/docs/alexa/smapi/skill-simulation-api.html)",
  version: "0.0.1",
  type: "action",
  props: {
    app,
    skillId: {
      propDefinition: [
        app,
        "skillId",
      ],
    },
    stage: {
      propDefinition: [
        app,
        "stage",
      ],
    },
    content: {
      propDefinition: [
        app,
        "inputContent",
      ],
    },
    locale: {
      propDefinition: [
        app,
        "deviceLocale",
      ],
    },
  },
  methods: {
    simulateSkill({
      skillId, stage, ...args
    }) {
      return this.app.post({
        path: `/skills/${skillId}/stages/${stage}/simulations`,
        ...args,
      });
    },
  },
  async run({ $ }) {
    const {
      simulateSkill,
      skillId,
      stage,
      content,
      locale,
    } = this;

    const response = await simulateSkill({
      $,
      skillId,
      stage,
      data: {
        session: {
          mode: "DEFAULT",
        },
        input: {
          content,
        },
        device: {
          locale,
        },
      },
    });

    $.export("$summary", `Successfully simulated skill with ID: ${response.id}`);

    return response;
  },
};

Action Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

Label	Prop	Type	Description
Amazon Alexa	`app`	`app`	This component uses the Amazon Alexa app.
Skill ID	`skillId`	`string`	The unique identifier for the Alexa skill
Stage	`stage`	`string`	Select a value from the drop down menu:`developmentlive`
Input Content	`content`	`string`	Utterance text from a user to Alexa.
Device Locale	`locale`	`string`	Select a value from the drop down menu:`en-USen-GBen-CAen-AUde-DEfr-FRen-INja-JP`

Action Authentication#

Amazon Alexa uses OAuth authentication. When you connect your Amazon Alexa account, Pipedream will open a popup window where you can sign into Amazon Alexa and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Amazon Alexa API.

Pipedream requests the following authorization scopes when you connect your account:

profile:user_idalexa::ask:skills:readwritealexa::ask:skills:test