README.md

# Alexa

Provides support for implementing an Amazon Alexa Skill.

## Installation

The package can be installed as:

  1. Add alexa to your list of dependencies in `mix.exs`:

        def deps do
          [{:alexa, "~> 0.1.6"}]
        end

  2. Add alexa to your list of applications in `mix.exs`:

        def application do
          [applications: [:logger, :alexa]]
        end

## Usage

Creating a new Alexa skill is easy.

    defmodule MyAwesomeSkill do
      use Alexa.Skill, app_id: "<alexa_skill_app_id>"      

      def handle_intent("SayHello", request, response) do
        response |> say("Hello World!")
      end
    end

This will register your skill with the Alexa module. It will be used to
handle any incoming requests with the matching app_id.

Then create an app that exposes an endpoint so that you can receive incoming
Alexa requests.

Here's an example plug implementation:

    defmodule Router do
      use Plug.Router

      plug :match
      plug :dispatch

      post "/command" do
        {:ok, body, conn} = read_body(conn)
        request = Poison.decode!(body, as: %Alexa.Request{})
        response = Alexa.handle_request(request)
        conn = send_resp(conn, 200, Poison.encode!(response))
        conn = %{conn | resp_headers: [{"content-type", "application/json"}]}
        conn
      end
    end