README

This project is deprecated. Please move to https://github.com/phoice/phlexa-expressive-skeleton

PHP skeleton application for Amazon Alexa Skills

With this PHP skeleton application you can easily setup your own PHP based Amazon Alexa skills.

Dependencies

This skeleton application is built with Zend\Expressive. For further details about the Zend\Expressive micro-framework please refer to the official docs.

Installation

Create a new project based on the skeleton application simply with Composer:

composer create-project travello-gmbh/amazon-alexa-skill-skeleton name-of-your-project

What you get

A Zend\Expressive application setup for you to handle requests from Amazon Alexa and to send your responses back to Alexa. The application is based on the Amazon Alexa Skill Library
An Alexa application based on the Amazon Skill Library with a simple HelloIntent to send some messages back to the user. It even contains a privacy page ready to use.
A text helper for the Alexa Application to handle messages and titles for your skill.
Signature validation is already built-in.
Request logging is also setup for you.

Little tutorial

Create an account at the Amazon Developer Portal: https://developer.amazon.com/de/
Switch to the Alexa section and choose the Alexa Skills Kit.https://developer.amazon.com/edw/home.html#/skills
Add a new skill.
In the Skill information:
- Choose the "Custom Interaction Model" and a Language
- Enter a name for your skill "Hello World" and an invocation name "hello world"
- Save
On the Interaction model:
- Launch the Skill Builder
- Add an Intent with the Name "HelloIntent"
- Add "hello world" as a sample utterance and press enter
- Save the model
- Build the model
Proceed to the configuration:
- Select the HTTPS endpoint and pick a geographical region
- Now copy the URL of your server (see below) as the endpoint URL.
- Save
Proceed to the SSL Certificate:
- Choose the appropriate option.
- Save
Proceed to the Test:
- Now you can test your new skill.
Fill in the Publishing Information and Privacy & Compliance section when you finished developing and testing the skill.

For further details please refer to the docs.

Setup your server

To get your skill running with PHP you need to setup your server which supports PHP 7. Install the application and setup a SSL Certificate. For further details please refer to the docs.

If you have setup your server you can test the Hello example skill with the following URL: https://your.server.com/hello/

Just sent a POST request (for example with Postman) with these headers:

Content-Type: application/json
signaturecertchainurl : https://s3.amazonaws.com/echo.api/echo-api-cert-4.pem
signature: B/bxAdkIabkzsScfUsSfkz7pJrNLc1eoOOLk8qwG1ZudQRv7KcvyNa/91g74Zg3cRpifXEco4669MaZb4Cqs+vZ9TaTfftAMzy/Pc79AMuf1dU6GfUU7tp6cuavfqTD8cWlYN5TjEMCJbS1Y+VU929mX0edOZcZin7db6bOoZHu5gU8OSQ2r+6UMk88z5uuSjPyt9Du9vaC3Ics/Br30fEIplIgCt4y/UGRK76Rqo4L/DuNjty3o2mcU8bICK5xfZwCeH7b5UFwdjngtp8VfhKPtosZmCuWvMn+y9HoS06ll9cdI1FPLN9w7KwMZFY8UzTc+0GfAwntxzlowAwkPhQ==

To simulate the launch of the skill use this body:

{
  "session": {
    "sessionId": "SessionId.test",
    "application": {
      "applicationId": "amzn1.ask.skill.place-your-skill-id-here"
    },
    "attributes": {},
    "user": {
      "userId": "amzn1.ask.account.test"
    },
    "new": true
  },
  "request": {
    "type": "LaunchRequest",
    "requestId": "EdwRequestId.test",
    "locale": "de-DE",
    "timestamp": "2017-01-26T20:38:55Z"
  },
  "version": "1.0"
}

And to test the HelloIntent use this body:

{
  "session": {
    "sessionId": "SessionId.test",
    "application": {
      "applicationId": "amzn1.ask.skill.place-your-skill-id-here"
    },
    "attributes": {},
    "user": {
      "userId": "amzn1.ask.account.test"
    },
    "new": true
  },
  "request": {
    "type": "IntentRequest",
    "requestId": "EdwRequestId.test",
    "locale": "de-DE",
    "timestamp": "2017-01-27T20:29:59Z",
    "intent": {
      "name": "HelloIntent",
      "slots": {}
    }
  },
  "version": "1.0"
}

Configuration

Have a closer look at these configuration files for activating the signature validation and the request logging feature.

/config/autoload/travello-alexa.config.global.php
/config/autoload/travello-alexa.config.development.php

travello-gmbh / amazon-alexa-skill-skeleton

Maintainers

Details