はじめに

SlackのIntegrateまわりを使う演習としてまとめています。
Slach CommandsとWebHooksの連携まわりは
楽天ブックス書籍検索APIと連携した簡易な構成です。

環境

楽天API
Slack
- Slash Commands
- Incoming WebHooks
外部APIを呼ぶためのWebサーバ

手順

楽天APIでのアプリID発行

デベロッパー登録後にアプリIDを発行します

APIテストフォーム：楽天ブックス書籍検索API
https://webservice.rakuten.co.jp/explorer/api/BooksBook/Search/

Slack - Slash Commands

Slack - Incoming WebHooks

設定したアイコン画像はこちらから使わせてもらいました
http://dojin-shi.info/?p=2966

Webサーバ上にスクリプトを置く

SlackのSlashCommand経由で投げられたリクエストを受ける
- Slash Commandsから受けたtokenでのフィルタリング
- 設定されたパラメータの設定有無
リクエストに含まれるタイトル名を条件に楽天APIから書籍データを取得する
- 取得データの数の制限など
JSONで受け取った内容から必要なパラメータ抽出
SlackのWebHookへ投げる
- SlackのPayloadのフォーマットに整形
- POSTでリクエストを送信

phpで書いてみました。

index.php

<?php

require_once('settings.php');

if ($_POST['token'] != $TOKEN_SLACK_COMMAND){
    echo 'ERROR';
    return;
}

 /**
  * @see https://webservice.rakuten.co.jp/api/booksbooksearch/
  */

$data_post_rakuten = array();
$data_post_rakuten['format']='json';
$data_post_rakuten['booksGenreId']='001';
$data_post_rakuten['applicationId']= $APPLICATIONID;
$data_post_rakuten['sort']='-releaseDate';
$data_post_rakuten['size']=9; //comic only
$data_post_rakuten['hits']=10;

if ($_POST['text'] != ""){
    $data_post_rakuten['title'] = $_POST['text'];
}

$response = post_data($URL_RAKUTEN_BOOKSEARCH, $data_post_rakuten);
$result = json_decode($response,true);

//書籍data
$attachments = array();
for($itm = 0; $itm < count($result['Items']); $itm++){
    $info =  $result["Items"][$itm]["Item"];

    $attachment = array();
    $attachment["title"] = $info["title"];
    $attachment["title_link"] = $info["itemUrl"];

    $attachment["thumb_url"] = $info["largeImageUrl"];

    $attachment["fields"][0]["title"]= "発売日";
    $attachment["fields"][0]["value"]= $info["salesDate"];
    $attachment["fields"][0]["short"]= "true";

    $attachment["fields"][1]["title"]= "作者";
    $attachment["fields"][1]["value"]= $info["author"];
    $attachment["fields"][1]["short"]= "true";

    //iconだけの出力できなかった
    //$attachment["author_name"] = "楽天Webサービス";
    $attachment["author_icon"] = 'http://webservice.rakuten.co.jp/img/credit/200709/credit_7052.gif';

    $attachments[$itm] = $attachment;
}

//postdata全体
$itemInfo = array();
$itemInfo['attachments'] = $attachments;
$itemInfo['text']=  "検索:" .$_POST['text'];
$encode = json_encode($itemInfo);

$send_data = array();
$send_data["payload"]= $encode;

$response = post_data($URL_SLACK_WEBHOOK, $send_data);

echo $response;


exit;

 /**
  * @param string $url
  * @param mixed[] $data
  *
  * @return response data
  */

function post_data($url, $data){
    $postString = http_build_query($data, '', '&');

    $ch = curl_init($url);

    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $postString);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

    $response = curl_exec($ch);

    curl_close($ch);

    return $response;
}

?>

settings.php


<?php
$APPLICATIONID ='';
$URL_RAKUTEN_BOOKSEARCH = 'https://app.rakuten.co.jp/services/api/BooksBook/Search/20130522';
$URL_SLACK_WEBHOOK = 'https://hooks.slack.com/services/XXXXXXX/XXXXXX/XXXXXXXXXXX';
$TOKEN_SLACK_COMMAND= 'XXXXXXXXXXXXXXXXXXXXXXXXX'

?>