<p>自作アプリ作る作る詐欺をしている永元です。<br />
Herokuの無料枠が廃止されてから1年以上たちました。<br />
今更ながら<br />
「とりあえずRailsアプリをデプロイするためのプラットフォームを試そう」<br />
と思い立ったので、実際に手を動かしていくつかのプラットフォームを試してみました。</p>
<h2 id="%E9%81%B8%E5%AE%9A%E5%9F%BA%E6%BA%96"><a class="header-anchor-link" href="#%E9%81%B8%E5%AE%9A%E5%9F%BA%E6%BA%96" aria-hidden="true"></a> 選定基準</h2>
<p>次の前提をもとにプラットフォームを選びました。</p>
<ul>
<li><a href="https://github.com/rails/docked" target="_blank" rel="nofollow noopener noreferrer">https://github.com/rails/docked</a> で構築した簡単なRailsアプリをデプロイする</li>
<li>リポジトリはGitHubで管理し、そこから容易にデプロイできると望ましい</li>
<li>東京（あるいはアジア・オセアニア）に利用可能なリージョンがある</li>
</ul>
<p>デプロイを試したアプリは下記に公開しています。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__0174eb87ed886" src="https://embed.zenn.studio/card#zenn-embedded__0174eb87ed886" data-content="https%3A%2F%2Fgithub.com%2Fnagamoto%2Fweblog" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/nagamoto/weblog" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/nagamoto/weblog</a></p>
<h3 id="%E5%80%99%E8%A3%9C%E3%83%97%E3%83%A9%E3%83%83%E3%83%88%E3%83%95%E3%82%A9%E3%83%BC%E3%83%A0"><a class="header-anchor-link" href="#%E5%80%99%E8%A3%9C%E3%83%97%E3%83%A9%E3%83%83%E3%83%88%E3%83%95%E3%82%A9%E3%83%BC%E3%83%A0" aria-hidden="true"></a> 候補プラットフォーム</h3>
<p>今回デプロイまで行ったのは次の3つです。<br />
<a href="https://railway.app" target="_blank" rel="nofollow noopener noreferrer">Railway</a><br />
<a href="https://app.koyeb.com" target="_blank" rel="nofollow noopener noreferrer">Koyeb</a><br />
<a href="https://dashboard.render.com" target="_blank" rel="nofollow noopener noreferrer">Render</a></p>
<p>他には<a href="https://fly.io/" target="_blank" rel="nofollow noopener noreferrer">Fly.io</a>も有名で評判が良いようです。</p>
<h2 id="%E3%83%87%E3%83%97%E3%83%AD%E3%82%A4%E3%81%AE%E6%BA%96%E5%82%99"><a class="header-anchor-link" href="#%E3%83%87%E3%83%97%E3%83%AD%E3%82%A4%E3%81%AE%E6%BA%96%E5%82%99" aria-hidden="true"></a> デプロイの準備</h2>
<p><a href="https://github.com/nagamoto/weblog" target="_blank" rel="nofollow noopener noreferrer">公開しているこのアプリ</a>は<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__82e4fc8ce4cb3" src="https://embed.zenn.studio/card#zenn-embedded__82e4fc8ce4cb3" data-content="https%3A%2F%2Fgithub.com%2Frails%2Fdocked" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/rails/docked" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/rails/docked</a><br style="display:none" />
にサンプルとして記載されているアプリを同じ手順で作成しました。</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash">docked rails new weblog
<span class="token builtin class-name">cd</span> weblog
docked rails generate scaffold post title:string body:text
docked rails db:migrate
docked rails server
</code></pre></div><p>これでlocal環境での起動が確認できます。<br />
作成したアプリをGitHub上にリポジトリにpushして準備完了です。</p>
<h2 id="%E3%83%97%E3%83%A9%E3%83%83%E3%83%88%E3%83%95%E3%82%A9%E3%83%BC%E3%83%A0%E3%81%94%E3%81%A8%E3%81%AE%E3%83%87%E3%83%97%E3%83%AD%E3%82%A4"><a class="header-anchor-link" href="#%E3%83%97%E3%83%A9%E3%83%83%E3%83%88%E3%83%95%E3%82%A9%E3%83%BC%E3%83%A0%E3%81%94%E3%81%A8%E3%81%AE%E3%83%87%E3%83%97%E3%83%AD%E3%82%A4" aria-hidden="true"></a> プラットフォームごとのデプロイ</h2>
<h3 id="railway"><a class="header-anchor-link" href="#railway" aria-hidden="true"></a> <a href="https://railway.app" target="_blank" rel="nofollow noopener noreferrer">Railway</a></h3>
<p>公式サイトにチュートリアルまで整備されています。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__9d74903dc98db" src="https://embed.zenn.studio/card#zenn-embedded__9d74903dc98db" data-content="https%3A%2F%2Fdocs.railway.app%2Ftutorials%2Fgetting-started" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://docs.railway.app/tutorials/getting-started" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://docs.railway.app/tutorials/getting-started</a></p>
<p>CLIでの操作にも対応していますが、今回はWEBアプリのUIからデプロイを試してみました。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__db8b4588364da" src="https://embed.zenn.studio/card#zenn-embedded__db8b4588364da" data-content="https%3A%2F%2Frailway.app%2Fnew" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://railway.app/new" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://railway.app/new</a><br style="display:none" />
からデプロイ設定ができます。おおまかな手順は次のとおりです。</p>
<ol>
<li>デプロイ方法を選ぶ</li>
<li>デプロイするリポジトリを選ぶ</li>
<li>環境変数設定を行う(スキップ可能ですが、環境変数RAILS_MASTER_KEYの設定は必要です)</li>
</ol>
<p><img src="/images/posts/app-deploy-some-platforms/Railway_setting.png" alt="環境変数設定画面" /></p>
<p>Railwayにはシンガポールリージョンがあるようです。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__f8d0c17c5e6f" src="https://embed.zenn.studio/card#zenn-embedded__f8d0c17c5e6f" data-content="https%3A%2F%2Fdocs.railway.app%2Freference%2Fdeployment-regions" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://docs.railway.app/reference/deployment-regions" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://docs.railway.app/reference/deployment-regions</a></p>
<h3 id="koyeb"><a class="header-anchor-link" href="#koyeb" aria-hidden="true"></a> <a href="https://app.koyeb.com" target="_blank" rel="nofollow noopener noreferrer">Koyeb</a></h3>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__dee6c5fb7aa13" src="https://embed.zenn.studio/card#zenn-embedded__dee6c5fb7aa13" data-content="https%3A%2F%2Fwww.koyeb.com%2Fdocs%2Fdeploy%2Fruby-on-rails" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.koyeb.com/docs/deploy/ruby-on-rails" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.koyeb.com/docs/deploy/ruby-on-rails</a><br style="display:none" />
こちらのページに記載されている通りの手順で滞りなくデプロイできました。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__50b582ed072a8" src="https://embed.zenn.studio/card#zenn-embedded__50b582ed072a8" data-content="https%3A%2F%2Fapp.koyeb.com%2Fapps%2Fnew" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://app.koyeb.com/apps/new" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://app.koyeb.com/apps/new</a><br style="display:none" />
からデプロイ設定ができます。おおまかな手順は次のとおりです。</p>
<ol>
<li>デプロイ方法を選ぶ(GitHub or Docker)</li>
<li>インポートするプロジェクトを選ぶ(GitHubならリポジトリ選択)</li>
<li>各種設定を行う(環境変数RAILS_MASTER_KEYの設定は必要)</li>
</ol>
<p><img src="/images/posts/app-deploy-some-platforms/koyabs_settings.png" alt="settingページ" /></p>
<p>有料アカウントであれば日本リージョンを選択できそうです。</p>
<h3 id="render"><a class="header-anchor-link" href="#render" aria-hidden="true"></a> <a href="https://dashboard.render.com" target="_blank" rel="nofollow noopener noreferrer">Render</a></h3>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__224a3f58327ee" src="https://embed.zenn.studio/card#zenn-embedded__224a3f58327ee" data-content="https%3A%2F%2Fdocs.render.com%2Fdeploy-rails" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://docs.render.com/deploy-rails" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://docs.render.com/deploy-rails</a><br style="display:none" />
こちらのページに記載されている通りの手順で滞りなくデプロイできました。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__b04099857e3a8" src="https://embed.zenn.studio/card#zenn-embedded__b04099857e3a8" data-content="https%3A%2F%2Fdashboard.render.com%2Fcreate%3Ftype%3Dweb" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://dashboard.render.com/create?type=web" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://dashboard.render.com/create?type=web</a><br style="display:none" />
からデプロイ設定ができます。おおまかな手順は次のとおりです。</p>
<ol>
<li>デプロイ方法を選ぶ(Gitリポジトリ or image)</li>
<li>インポートするプロジェクトを選ぶ(GitHubならリポジトリ選択)</li>
<li>各種設定を行う(環境変数RAILS_MASTER_KEYの設定は必要)</li>
</ol>
<p><img src="/images/posts/app-deploy-some-platforms/render.png" alt="各種設定画面" /></p>
<p>最初からシンガポールリージョンを選べるのがいいです。<br />
個人的にダッシュボードはRenderが一番わかりやすかったです。</p>
<h2 id="%E6%89%80%E6%84%9F"><a class="header-anchor-link" href="#%E6%89%80%E6%84%9F" aria-hidden="true"></a> 所感</h2>
<p>どのプラットフォームも、アカウントを作成してGitHub連携をすれば、わずかな設定のみで簡単にデプロイができました。おかげで特にアドバイスもなく、この記事の内容が薄くなりました。</p>
<p>いくつかのプラットフォームにシンガポールリージョンがある中で、日本リージョンがないことにわずかながら悔しさを覚えました。実際のところ、シンガポールリージョンであれば遅延はだいたい気にしないですむのでありがたい限りです。</p>
<p>また、プラットフォームを選ぶ際に、無料枠やリージョン、DBを追加する場合の料金やその他もろもろの拡張性なども含めて調べるとキリがなさそうでした。プレイベートなちょっとしたアプリもAWSにデプロイしていいんじゃないかな？と感じました。<br />
なんてときにちょうどいい記事が弊ブログにあるのでこちらの記事もどうぞ！<br />
<a href="https://tech.crassone.jp/posts/deploy-rails7_1-with-aws-copilot-cli" target="_blank" rel="nofollow noopener noreferrer">Rails7.1アプリをAWS Copilot CLIでAWS Fargateにデプロイする</a></p>
<h2 id="%E5%8F%82%E8%80%83%E6%96%87%E7%8C%AE"><a class="header-anchor-link" href="#%E5%8F%82%E8%80%83%E6%96%87%E7%8C%AE" aria-hidden="true"></a> 参考文献</h2>
<ul>
<li><a href="https://blog.unasuke.com/2022/compare-heroku-alternatives/" target="_blank" rel="nofollow noopener noreferrer">RailsアプリをHerokuから移行するならどれがいいのか比較する</a></li>
<li><a href="https://zenn.dev/sesere/articles/1e302e22c26b3e" target="_blank">💻 Railsをdeployする時に使えそうなPaaSのメモと簡単な評価</a></li>
</ul>
<h2 id="we-are-hiring!"><a class="header-anchor-link" href="#we-are-hiring!" aria-hidden="true"></a> We Are Hiring!</h2>
<p>クラッソーネに少しでも興味を持っていただけたら、気軽にご連絡ください。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__6f4763fa9b181" src="https://embed.zenn.studio/card#zenn-embedded__6f4763fa9b181" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.crassone.co.jp/recruit/engineer/</a></p>



自作アプリ作る作る詐欺をしている永元です。
Herokuの無料枠が廃止されてから1年以上たちました。
今更ながら
「とりあえずRailsアプリをデプロイするためのプラットフォームを試そう」
と思い立ったので、実際に手を動かしていくつかのプラットフォームを試してみました。

選定基準
次の前提をもとにプラットフォームを選びました。
https://github.com/rails/docked で構築した簡単なRailsアプリをデプロイする
リポジトリはGitHubで管理し、そこから容易にデプロイできると望ましい
東京（あるいはアジア・オセアニア）に利用可能なリージョンがある

デプロイを試したアプリは下記に公開しています。
https://github.com/nagamoto/weblog

候補プラットフォーム
今回デプロイまで行ったのは次の3つです。
Railway
Koyeb
Render

他にはFly.ioも有名で評判が良いようです。

デプロイの準備
公開しているこのアプリは
https://github.com/rails/docked
にサンプルとして記載されているアプリを同じ手順で作成しました。

docked rails new weblog
cd weblog
docked rails generate scaffold post title:string body:text
docked rails db:migrate
docked rails server

これでlocal環境での起動が確認できます。
作成したアプリをGitHub上にリポジトリにpushして準備完了です。

プラットフォームごとのデプロイ
Railway
公式サイトにチュートリアルまで整備されています。
https://docs.railway.app/tutorials/getting-started

CLIでの操作にも対応していますが、今回はWEBアプリのUIからデプロイを試してみました。
https://railway.app/new
からデプロイ設定ができます。おおまかな手順は次のとおりです。
デプロイ方法を選ぶ
デプロイするリポジトリを選ぶ
環境変数設定を行う(スキップ可能ですが、環境変数RAILSMASTERKEYの設定は必要です)

環境変数設定画面

Railwayにはシンガポールリージョンがあるようです。
https://docs.railway.app/reference/deployment-regions

Koyeb
https://www.koyeb.com/docs/deploy/ruby-on-rails
こちらのページに記載されている通りの手順で滞りなくデプロイできました。

https://app.koyeb.com/apps/new
からデプロイ設定ができます。おおまかな手順は次のとおりです。
デプロイ方法を選ぶ(GitHub or Docker)
インポートするプロジェクトを選ぶ(GitHubならリポジトリ選択)
各種設定を行う(環境変数RAILSMASTERKEYの設定は必要)

settingページ

有料アカウントであれば日本リージョンを選択できそうです。

Render
https://docs.render.com/deploy-rails
こちらのページに記載されている通りの手順で滞りなくデプロイできました。

https://dashboard.render.com/create?type=web
からデプロイ設定ができます。おおまかな手順は次のとおりです。
デプロイ方法を選ぶ(Gitリポジトリ or image)
インポートするプロジェクトを選ぶ(GitHubならリポジトリ選択)
各種設定を行う(環境変数RAILSMASTERKEYの設定は必要)

各種設定画面

最初からシンガポールリージョンを選べるのがいいです。
個人的にダッシュボードはRenderが一番わかりやすかったです。

所感
どのプラットフォームも、アカウントを作成してGitHub連携をすれば、わずかな設定のみで簡単にデプロイができました。おかげで特にアドバイスもなく、この記事の内容が薄くなりました。

いくつかのプラットフォームにシンガポールリージョンがある中で、日本リージョンがないことにわずかながら悔しさを覚えました。実際のところ、シンガポールリージョンであれば遅延はだいたい気にしないですむのでありがたい限りです。

また、プラットフォームを選ぶ際に、無料枠やリージョン、DBを追加する場合の料金やその他もろもろの拡張性なども含めて調べるとキリがなさそうでした。プレイベートなちょっとしたアプリもAWSにデプロイしていいんじゃないかな？と感じました。
なんてときにちょうどいい記事が弊ブログにあるのでこちらの記事もどうぞ！
Rails7.1アプリをAWS Copilot CLIでAWS Fargateにデプロイする

参考文献
RailsアプリをHerokuから移行するならどれがいいのか比較する
💻 Railsをdeployする時に使えそうなPaaSのメモと簡単な評価

We Are Hiring!
クラッソーネに少しでも興味を持っていただけたら、気軽にご連絡ください。

https://www.crassone.co.jp/recruit/engineer/


Heroku以外にRailsアプリをデプロイしてみた

<p>子供の成長に喜びつつも、自分は成長しているのか？と焦りも覚えながら育児をしている永元です。<br />
2022年のほとんどを育児休業するという珍しい経験をしたため、記事に残しておきます。</p>
<h2 id="%E3%81%BE%E3%81%88%E3%81%8C%E3%81%8D"><a class="header-anchor-link" href="#%E3%81%BE%E3%81%88%E3%81%8C%E3%81%8D" aria-hidden="true"></a> まえがき</h2>
<ul>
<li>これは1年間育児休業をしたエンジニアの所感記事です</li>
<li>育児休業中ごりごりにスキルアップ！自作アプリをリリース！のような鉄人の話はありません</li>
<li>子供2人の核家族で近隣に親戚なし</li>
</ul>
<h2 id="%E8%82%B2%E5%85%90%E4%BC%91%E6%A5%AD%E9%96%8B%E5%A7%8B%E5%89%8D"><a class="header-anchor-link" href="#%E8%82%B2%E5%85%90%E4%BC%91%E6%A5%AD%E9%96%8B%E5%A7%8B%E5%89%8D" aria-hidden="true"></a> 育児休業開始前</h2>
<h3 id="%E5%87%BA%E6%9D%A5%E4%BA%8B%E3%83%BB%E3%82%84%E3%81%A3%E3%81%9F%E3%81%93%E3%81%A8"><a class="header-anchor-link" href="#%E5%87%BA%E6%9D%A5%E4%BA%8B%E3%83%BB%E3%82%84%E3%81%A3%E3%81%9F%E3%81%93%E3%81%A8" aria-hidden="true"></a> 出来事・やったこと</h3>
<p>安定期を過ぎ、出産予定3ヶ月前には会社に連絡・申請を始める。<br />
プライベートなことであり、場合によってはセンシティブなことでもあると思い、自分が考える必要な範囲の同僚に伝える。<br />
ほぼすべての人に伝えたのはおよそ1ヶ月前。</p>
<h3 id="%E6%89%80%E6%84%9F"><a class="header-anchor-link" href="#%E6%89%80%E6%84%9F" aria-hidden="true"></a> 所感</h3>
<p>事前に連絡したものの、思っていたより伝えるべき関係者が多く、報連相の下手さが出てしまった。<br />
育児休業を取得することは本人としてはセンシティブな内容でないので、早い段階でどんどん伝えて、やるべきことをあぶり出した方がもっとよかった。<br />
安定期を過ぎたら、変に気を遣わず、仕事で会う人全員に伝えておくくらいで良さそう。</p>
<h2 id="%E8%82%B2%E5%85%90%E4%BC%91%E6%A5%AD%E4%B8%AD"><a class="header-anchor-link" href="#%E8%82%B2%E5%85%90%E4%BC%91%E6%A5%AD%E4%B8%AD" aria-hidden="true"></a> 育児休業中</h2>
<h3 id="%E4%BA%88%E6%83%B3"><a class="header-anchor-link" href="#%E4%BA%88%E6%83%B3" aria-hidden="true"></a> 予想</h3>
<p>正直少し舐めていた。<br />
子供1人の大変さが1なら子供2人なら1.5とか1.7くらいだろうと思っていた。</p>
<h3 id="%E5%87%BA%E6%9D%A5%E4%BA%8B%E3%83%BB%E3%82%84%E3%81%A3%E3%81%9F%E3%81%93%E3%81%A8-1"><a class="header-anchor-link" href="#%E5%87%BA%E6%9D%A5%E4%BA%8B%E3%83%BB%E3%82%84%E3%81%A3%E3%81%9F%E3%81%93%E3%81%A8-1" aria-hidden="true"></a> 出来事・やったこと</h3>
<p>感染症の流行で上の子が保育園に満足に通えない時期が2ヶ月程度発生した。<br />
上の子と妻は感染。下の子と私が家庭内隔離で感染をなんとか回避できた。</p>
<p>感染症が流行している状況では、復職してもろくに働けないだろうことから、育児休業を大きく延長する決断をし、手続きをした。<br />
※育児休業の延長終了日の繰下げ(延長)は通常1回に限られており、様子を見ながら少しずつ延長することはできないため。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__48835fc29e937" src="https://embed.zenn.studio/card#zenn-embedded__48835fc29e937" data-content="https%3A%2F%2Felaws.e-gov.go.jp%2Fdocument%3Flawid%3D403AC0000000076" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://elaws.e-gov.go.jp/document?lawid=403AC0000000076" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://elaws.e-gov.go.jp/document?lawid=403AC0000000076</a></p>
<p>分かってはいたものの、子供が0ヶ月〜12ヶ月の間で育児の負担は大きな波があった。</p>
<ul>
<li>授乳頻度が高い時期</li>
<li>夜泣き・寝かしつけの負担が大きい時期</li>
<li>母乳による免疫が切れてよく病気になる時期</li>
<li>はいはいや歩けるようになったばかりで全く目が離せない時期</li>
</ul>
<p>これらの時期は負担が大きく、それらの間に比較的楽な時期があった。<br />
楽な時期には自粛中でもできる趣味を楽しんだり、少しはソフトウェアエンジニアリングの勉強をした。<br />
HugoやNext.jsで静的サイトを作ってみたり、結局Railsに戻ってきたり、技術のつまみ食いだけはやった。<br />
※ほとんど途中で投げ出したためろくな成果物はない</p>
<h3 id="%E6%89%80%E6%84%9F-1"><a class="header-anchor-link" href="#%E6%89%80%E6%84%9F-1" aria-hidden="true"></a> 所感</h3>
<p>2人を育児することは、1人の育児するより2倍以上にしんどいときがあった。予想よりしんどかった。<br />
上の子が拗ねたり、2人で喧嘩したりするのは想像通りだけどやはり対処は難しい。<br />
保育園に通う上の子がそれなりに病気をもらってくるため、下の子がよく体調を崩すのが特にきつかった。<br />
※下の子も保育園に入ればどうせ病気はもらうし、復職してから体調を崩すよりは良い。</p>
<p>感染症の流行がピークの時期は、育児に専念しているにも関わらず相当に辛かった。</p>
<p>休業の延長については会社に感謝しかない。手続きは大変だし、人手の確保・調整も発生したはず。</p>
<p>育児が少し楽になった時期に余暇時間を作れたのはよい息抜きになった。<br />
夫婦が交代で息抜きするスタイルが上手くいった。子供は可愛いが、息抜きは必要。<br />
ただしスプラトゥーン最新作はやりすぎた。復職前の不安は勉強を怠った自分のせい。</p>
<h2 id="%E5%BE%A9%E8%81%B7%E5%BE%8C"><a class="header-anchor-link" href="#%E5%BE%A9%E8%81%B7%E5%BE%8C" aria-hidden="true"></a> 復職後</h2>
<h3 id="%E4%BA%88%E6%83%B3-1"><a class="header-anchor-link" href="#%E4%BA%88%E6%83%B3-1" aria-hidden="true"></a> 予想</h3>
<p>ソフトウェアエンジニアとしてついていけない状態になっているのではないか？<br />
という漠然とした不安はあった。<br />
子供がかわいいからもっと休んでいたい()という気持ちもあった。</p>
<h3 id="%E6%89%80%E6%84%9F-2"><a class="header-anchor-link" href="#%E6%89%80%E6%84%9F-2" aria-hidden="true"></a> 所感</h3>
<p>最低限触っていればブランクは軽減できる…<br />
と思いきやソフトスキル面のブランクを節々で感じた。<br />
報連相などの一般的な社会人力(もともと不得手)、チームでものごとを進める力が低下していた。<br />
休業中に複数人で物事を進める経験を積むのが難しいためかと思う。</p>
<p>子育てと仕事の両方をやることは、油断すると両方を怠慢にする言い訳ができてしまうため、これまで以上に己を律しなければならないと感じた。</p>
<p>ちなみに、6ヶ月より長い育児休業を取得すると家庭内キャッシュフローが大幅に悪化します。<br />
復職後、給料が入るまでの間が1番きついため、カードの支払いに失敗しないように気をつけた方がいいです。<br />
私は失敗しました。</p>
<h2 id="%E3%81%BE%E3%81%A8%E3%82%81"><a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" aria-hidden="true"></a> まとめ</h2>
<p>育児休業は休暇ではないし、楽ではない。<br />
でも子供は可愛いし、乳幼児はみるみる成長していくからたくさん見ていられる育児休業は良いぞ！</p>
<p>長期休業では技術的な勉強は大事だが、チームで仕事を進める力が落ちることを意識するのも大事。<br />
子供がいると感染症がより手強くなる。<br />
多数の手続きをスムーズに進めてくれたバックオフィスへの感謝の気持ちが大きくなった。<br />
快く休業させてくれるのは本当にありがたい。</p>
<h2 id="we-are-hiring!"><a class="header-anchor-link" href="#we-are-hiring!" aria-hidden="true"></a> We Are Hiring!</h2>
<p>クラッソーネに少しでも興味を持っていただけたら、気軽にご連絡ください。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__b609dab53ec0c" src="https://embed.zenn.studio/card#zenn-embedded__b609dab53ec0c" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.crassone.co.jp/recruit/engineer/</a></p>



子供の成長に喜びつつも、自分は成長しているのか？と焦りも覚えながら育児をしている永元です。
2022年のほとんどを育児休業するという珍しい経験をしたため、記事に残しておきます。

まえがき
これは1年間育児休業をしたエンジニアの所感記事です
育児休業中ごりごりにスキルアップ！自作アプリをリリース！のような鉄人の話はありません
子供2人の核家族で近隣に親戚なし

育児休業開始前
出来事・やったこと
安定期を過ぎ、出産予定3ヶ月前には会社に連絡・申請を始める。
プライベートなことであり、場合によってはセンシティブなことでもあると思い、自分が考える必要な範囲の同僚に伝える。
ほぼすべての人に伝えたのはおよそ1ヶ月前。

所感
事前に連絡したものの、思っていたより伝えるべき関係者が多く、報連相の下手さが出てしまった。
育児休業を取得することは本人としてはセンシティブな内容でないので、早い段階でどんどん伝えて、やるべきことをあぶり出した方がもっとよかった。
安定期を過ぎたら、変に気を遣わず、仕事で会う人全員に伝えておくくらいで良さそう。

育児休業中
予想
正直少し舐めていた。
子供1人の大変さが1なら子供2人なら1.5とか1.7くらいだろうと思っていた。

出来事・やったこと
感染症の流行で上の子が保育園に満足に通えない時期が2ヶ月程度発生した。
上の子と妻は感染。下の子と私が家庭内隔離で感染をなんとか回避できた。

感染症が流行している状況では、復職してもろくに働けないだろうことから、育児休業を大きく延長する決断をし、手続きをした。
※育児休業の延長終了日の繰下げ(延長)は通常1回に限られており、様子を見ながら少しずつ延長することはできないため。
https://elaws.e-gov.go.jp/document?lawid=403AC0000000076

分かってはいたものの、子供が0ヶ月〜12ヶ月の間で育児の負担は大きな波があった。
授乳頻度が高い時期
夜泣き・寝かしつけの負担が大きい時期
母乳による免疫が切れてよく病気になる時期
はいはいや歩けるようになったばかりで全く目が離せない時期

これらの時期は負担が大きく、それらの間に比較的楽な時期があった。
楽な時期には自粛中でもできる趣味を楽しんだり、少しはソフトウェアエンジニアリングの勉強をした。
HugoやNext.jsで静的サイトを作ってみたり、結局Railsに戻ってきたり、技術のつまみ食いだけはやった。
※ほとんど途中で投げ出したためろくな成果物はない

所感
2人を育児することは、1人の育児するより2倍以上にしんどいときがあった。予想よりしんどかった。
上の子が拗ねたり、2人で喧嘩したりするのは想像通りだけどやはり対処は難しい。
保育園に通う上の子がそれなりに病気をもらってくるため、下の子がよく体調を崩すのが特にきつかった。
※下の子も保育園に入ればどうせ病気はもらうし、復職してから体調を崩すよりは良い。

感染症の流行がピークの時期は、育児に専念しているにも関わらず相当に辛かった。

休業の延長については会社に感謝しかない。手続きは大変だし、人手の確保・調整も発生したはず。

育児が少し楽になった時期に余暇時間を作れたのはよい息抜きになった。
夫婦が交代で息抜きするスタイルが上手くいった。子供は可愛いが、息抜きは必要。
ただしスプラトゥーン最新作はやりすぎた。復職前の不安は勉強を怠った自分のせい。

復職後
予想
ソフトウェアエンジニアとしてついていけない状態になっているのではないか？
という漠然とした不安はあった。
子供がかわいいからもっと休んでいたい()という気持ちもあった。

所感
最低限触っていればブランクは軽減できる…
と思いきやソフトスキル面のブランクを節々で感じた。
報連相などの一般的な社会人力(もともと不得手)、チームでものごとを進める力が低下していた。
休業中に複数人で物事を進める経験を積むのが難しいためかと思う。

子育てと仕事の両方をやることは、油断すると両方を怠慢にする言い訳ができてしまうため、これまで以上に己を律しなければならないと感じた。

ちなみに、6ヶ月より長い育児休業を取得すると家庭内キャッシュフローが大幅に悪化します。
復職後、給料が入るまでの間が1番きついため、カードの支払いに失敗しないように気をつけた方がいいです。
私は失敗しました。

まとめ
育児休業は休暇ではないし、楽ではない。
でも子供は可愛いし、乳幼児はみるみる成長していくからたくさん見ていられる育児休業は良いぞ！

長期休業では技術的な勉強は大事だが、チームで仕事を進める力が落ちることを意識するのも大事。
子供がいると感染症がより手強くなる。
多数の手続きをスムーズに進めてくれたバックオフィスへの感謝の気持ちが大きくなった。
快く休業させてくれるのは本当にありがたい。

We Are Hiring!
クラッソーネに少しでも興味を持っていただけたら、気軽にご連絡ください。

https://www.crassone.co.jp/recruit/engineer/


エンジニアが１年間の育児休業で感じたこと

<p>こんにちは、プロダクト開発部の永元です。</p>
<p>クラッソーネではCTIシステムとしてGenesysを利用しており、管理する顧客情報を連携するためにいくらかハマることがありました。将来の自分のためにも記事として残しておきます。</p>
<h2 id="cti%E3%81%A8%E3%81%AF"><a class="header-anchor-link" href="#cti%E3%81%A8%E3%81%AF" aria-hidden="true"></a> CTIとは</h2>
<p>CTIは、Computer Telephony Integrationの略称です。ざっくり説明すると、所謂コールセンターの業務をサポートするシステムです。詳細に知りたい方は<a href="https://it-trend.jp/cti/article/23-0002" target="_blank" rel="nofollow noopener noreferrer">こちら</a>をどうぞ。</p>
<h2 id="genesys%E3%81%A8%E3%81%AF"><a class="header-anchor-link" href="#genesys%E3%81%A8%E3%81%AF" aria-hidden="true"></a> Genesysとは</h2>
<blockquote>
<p>従来のコールセンターを劇的に進化させる先進のCTIシステム。それが、ジェネシスのコンタクトセンター・ソリューションです。</p>
</blockquote>
<p><a href="https://www.genesys.com/ja-jp" target="_blank" rel="nofollow noopener noreferrer">コンタクトセンター・コールセンターソリューション | オムニチャネル・カスタマーエクスペリエンス | ジェネシス</a> より</p>
<p>GenesysはCTIシステム業界では大手で機能も充実しています。CTIシステムがB向けという性質を持ち、本社がアメリカのサービスなため、大手とは言え日本での認知度は高くなく、公式サイト以外の日本語情報も少ないです。</p>
<h2 id="%E9%80%A3%E7%B5%A1%E5%85%88%E3%81%AE%E6%89%B1%E3%81%84"><a class="header-anchor-link" href="#%E9%80%A3%E7%B5%A1%E5%85%88%E3%81%AE%E6%89%B1%E3%81%84" aria-hidden="true"></a> 連絡先の扱い</h2>
<p>Genesysでは「外部の連絡先」<sup class="footnote-ref"><a href="#fn-32da-1" id="fnref-32da-1">[1]</a></sup>という名前で顧客情報を扱います。また、「外部の連絡先」には個人と組織が存在します。エンジニアとしてAPIを扱う都合上、日本語訳より英語で覚えることをおすすめします。<br />
外部の連絡先 → external contacts<br />
外部の連絡先(個人) → external contacts(contacts)<br />
外部の連絡先(組織) → external contacts(organizations)</p>
<h2 id="%E3%83%8F%E3%83%9E%E3%82%8A%E3%83%9D%E3%82%A4%E3%83%B3%E3%83%88"><a class="header-anchor-link" href="#%E3%83%8F%E3%83%9E%E3%82%8A%E3%83%9D%E3%82%A4%E3%83%B3%E3%83%88" aria-hidden="true"></a> ハマりポイント</h2>
<p>新しいサービスを利用開始するときは多少ハマるのは当たり前だと思います。ここでは私が特にハマったことを紹介します。</p>
<h3 id="%E5%85%AC%E5%BC%8F%E3%83%89%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88%E3%83%9A%E3%83%BC%E3%82%B8%E3%81%AE%E9%96%B2%E8%A6%A7%E3%81%AB%E5%B0%91%E3%81%97%E6%85%A3%E3%82%8C%E3%81%8C%E5%BF%85%E8%A6%81"><a class="header-anchor-link" href="#%E5%85%AC%E5%BC%8F%E3%83%89%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88%E3%83%9A%E3%83%BC%E3%82%B8%E3%81%AE%E9%96%B2%E8%A6%A7%E3%81%AB%E5%B0%91%E3%81%97%E6%85%A3%E3%82%8C%E3%81%8C%E5%BF%85%E8%A6%81" aria-hidden="true"></a> 公式ドキュメントページの閲覧に少し慣れが必要</h3>
<p>公式ドキュメントは充実しており、うまく検索できれば目的の情報は見つかります。ただ少し慣れが必要です。</p>
<p>公式ドキュメントページは<a href="https://help.mypurecloud.com/" target="_blank" rel="nofollow noopener noreferrer">Resource Center</a>と<a href="https://developer.genesys.cloud/" target="_blank" rel="nofollow noopener noreferrer">Developer Center</a>と大きく2つに分かれていますが、統一感のあるデザインのため、混同しないように注意しましょう。開発者向けの情報はDeveloper Centerを当たりましょう。Resource Centerの検索ボックスからはサンプルコードなどの開発者が求める情報には辿り着けません。(自戒)</p>
<p>日本語のページもそれなりに存在しますが、英語ページしか存在しないことがよくあるため、最初から英語のページを見るのがおすすめです。</p>
<h4 id="%E7%89%B9%E3%81%AB%E3%82%88%E3%81%8F%E9%96%B2%E8%A6%A7%E3%81%99%E3%82%8B%E3%83%9A%E3%83%BC%E3%82%B8"><a class="header-anchor-link" href="#%E7%89%B9%E3%81%AB%E3%82%88%E3%81%8F%E9%96%B2%E8%A6%A7%E3%81%99%E3%82%8B%E3%83%9A%E3%83%BC%E3%82%B8" aria-hidden="true"></a> 特によく閲覧するページ</h4>
<ul>
<li><a href="https://developer.dev-genesys.cloud/api/rest/v2/externalcontacts/" target="_blank" rel="nofollow noopener noreferrer">External Contacts</a>: 外部連絡先関連のAPI一覧できます。顧客情報に関するAPIはだいたいここを見ればなんとかなります。</li>
<li><a href="https://developer.genesys.cloud/api/rest/client-libraries/#-i-class--devicon-javascript-guest-plain-colored----i--guest-chat-client---javascript" target="_blank" rel="nofollow noopener noreferrer">Software Development Kit (SDK)</a>: 各SDKとそのサンプルコードが一覧できます。</li>
<li><a href="https://developer.genesys.cloud/api/tutorials/" target="_blank" rel="nofollow noopener noreferrer">Tutorials</a>: 各環境・言語における様々な利用シーンのチュートリアル(サンプルコード)を一覧できます。自分の目的に近いサンプルが掲載されているととても嬉しいです。</li>
<li><a href="https://developer.genesys.cloud/developer-tools/" target="_blank" rel="nofollow noopener noreferrer">Developer Tools</a>: ブラウザで動作する開発者向けツールです。色んなAPIを試しに呼び出したり、サンプルコードを動かしたりできて便利です。</li>
</ul>
<h3 id="api%E5%88%A9%E7%94%A8%E3%82%92%E5%A7%8B%E3%82%81%E3%82%8B%E3%81%9F%E3%82%81%E3%81%ABweb%E3%82%A2%E3%83%97%E3%83%AA%E4%B8%8A%E3%81%8B%E3%82%89%E4%BA%8B%E5%89%8D%E6%BA%96%E5%82%99%E3%81%8C%E5%BF%85%E8%A6%81"><a class="header-anchor-link" href="#api%E5%88%A9%E7%94%A8%E3%82%92%E5%A7%8B%E3%82%81%E3%82%8B%E3%81%9F%E3%82%81%E3%81%ABweb%E3%82%A2%E3%83%97%E3%83%AA%E4%B8%8A%E3%81%8B%E3%82%89%E4%BA%8B%E5%89%8D%E6%BA%96%E5%82%99%E3%81%8C%E5%BF%85%E8%A6%81" aria-hidden="true"></a> API利用を始めるためにWEBアプリ上から事前準備が必要</h3>
<p>よくある話ではありますが、GenesysでもAPI利用を可能にする事前設定が必要です。利用する認証方法に応じた設定をしましょう。日本語・英語両方のヘルプページを貼っておきますが、APIやその認証方法に詳しい人は英語版だけを読んだほう理解が早いと思います。<br />
<a href="https://help.mypurecloud.com/articles/create-an-oauth-client/" target="_blank" rel="nofollow noopener noreferrer">Create an OAuth client - Genesys Cloud Resource Center</a><br />
<a href="https://jp-help.mypurecloud.com/articles/create-an-oauth-client/" target="_blank" rel="nofollow noopener noreferrer">OAuthクライアントを作成する-Genesysクラウドリソースセンター</a></p>
<p>GenesysAPIは複数の認証方法に対応しています。次のリンクを参照し、利用シーンに適した認証方法を選びましょう。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__f8938fec2fdcc" src="https://embed.zenn.studio/card#zenn-embedded__f8938fec2fdcc" data-content="https%3A%2F%2Fdeveloper.genesys.cloud%2Fapi%2Frest%2Fauthorization%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://developer.genesys.cloud/api/rest/authorization/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://developer.genesys.cloud/api/rest/authorization/</a></p>
<h3 id="ruby%E3%81%AEsdk%E3%81%8C%E3%81%AA%E3%81%84"><a class="header-anchor-link" href="#ruby%E3%81%AEsdk%E3%81%8C%E3%81%AA%E3%81%84" aria-hidden="true"></a> RubyのSDKがない</h3>
<p>厳密には「サポート中のRuby SDKがない」です。<br />
<a href="https://help.mypurecloud.com/articles/deprecation-genesys-cloud-ruby-sdk/" target="_blank" rel="nofollow noopener noreferrer">Deprecation: Genesys Cloud Ruby SDK - Genesys Cloud Resource Center</a><br />
Deprecationですが<a href="https://github.com/MyPureCloud/platform-client-sdk-ruby" target="_blank" rel="nofollow noopener noreferrer">Ruby SDKはGitHubに公開されている</a>ので参考にすることは可能です。実際に弊社では参考にして認証部分の実装を行いました。</p>
<p>Rubyにはありませんが、JavaScriptを始め、主要言語で複数種類のSDKが提供されています。公式SDKが豊富なのは非常にありがたいです。</p>
<h3 id="%E9%80%A3%E7%B5%A1%E5%85%88%E3%81%AE%E3%83%90%E3%83%AA%E3%83%87%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3"><a class="header-anchor-link" href="#%E9%80%A3%E7%B5%A1%E5%85%88%E3%81%AE%E3%83%90%E3%83%AA%E3%83%87%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3" aria-hidden="true"></a> 連絡先のバリデーション</h3>
<p>外部の連絡先(個人)の場合は姓・名が必須です。姓と名を分けずに管理しているところは対応が必要そうです。<br />
姓: 鈴木一郎<br />
名: .<br />
のように姓と名どちらかにフルネームで設定し、使わない方に意味はなくとも何某かの文字を設定する…といった回避方法はありますが、あまりおすすめしません。Genesysの担当者と自社の状況を踏まえて相談しましょう。</p>
<p>外部の連絡先(組織)の場合は組織名のみ必須です。こちらは特に躓くことはなさそうです。</p>
<h3 id="%E9%9B%BB%E8%A9%B1%E7%95%AA%E5%8F%B7%E3%81%AE%E5%BD%A2%E5%BC%8F"><a class="header-anchor-link" href="#%E9%9B%BB%E8%A9%B1%E7%95%AA%E5%8F%B7%E3%81%AE%E5%BD%A2%E5%BC%8F" aria-hidden="true"></a> 電話番号の形式</h3>
<p>"090xxxxxxxx"<br />
は電話番号として認識されません。電話番号冒頭の0は国内を意味するプレフィックスであり、GenesysのAPI利用時には日本の電話番号であることを明示する必要があるためです。冒頭の"0"を"+81"に置換した"+8190xxxxxxxx"であれば日本の携帯電話番号として認識され、APIから登録が可能です。</p>
<p>ちなみにGenesysのWEBアプリから入力するときは自動的にデフォルトで設定されている国コードに変換して保存してくれます。そのおかげでAPI利用時のエラー原因に気づきにくいです。</p>
<p>※電話番号のプレフィックスなど詳細については<a href="https://www.soumu.go.jp/main_sosiki/joho_tsusin/top/tel_number/q_and_a.html" target="_blank" rel="nofollow noopener noreferrer">総務省｜電気通信番号制度｜電話番号に関するQ&amp;A</a>の参照をおすすめします</p>
<h3 id="%E9%9B%BB%E8%A9%B1%E7%95%AA%E5%8F%B7%E6%A4%9C%E7%B4%A2%E3%81%AB%E7%99%96%E3%81%8C%E3%81%82%E3%82%8B"><a class="header-anchor-link" href="#%E9%9B%BB%E8%A9%B1%E7%95%AA%E5%8F%B7%E6%A4%9C%E7%B4%A2%E3%81%AB%E7%99%96%E3%81%8C%E3%81%82%E3%82%8B" aria-hidden="true"></a> 電話番号検索に癖がある</h3>
<p>"090xxxxxxxx"<br />
という携帯電話番号について検索したいときは<br />
"90-xxxx-xxxx"<br />
で検索しましょう。</p>
<p>冒頭の国を表すプレフィックスは削除し、ハイフン(全角半角どちらでも可らしい)ありの形式であればHITします。これを知らないと、<br />
「APIで外部の連絡先を作成して200レスポンスだったけど、作成したはずの連絡先が見つからない」<br />
と焦ることになります。(自戒)</p>
<p>また、この仕様はAPIを利用した検索・WEBアプリ上の検索どちらも同じ仕様です。Genesysで電話対応を行うスタッフにこそ、知らせたいです。</p>
<h2 id="%E6%9C%80%E5%BE%8C%E3%81%AB"><a class="header-anchor-link" href="#%E6%9C%80%E5%BE%8C%E3%81%AB" aria-hidden="true"></a> 最後に</h2>
<p>ハマった後に「早く担当者に聞いておけばよかったな。聞いたらすぐ解決してたな。」という反省が私にはありました。Genesysに限らず、新しいツール・サービスの利用を始めるときに多少ハマるのは仕方のないことです。早めに積極的に問い合わせていきたいですね。</p>
<h2 id="we-are-hiring!"><a class="header-anchor-link" href="#we-are-hiring!" aria-hidden="true"></a> We Are Hiring!</h2>
<p>クラッソーネに少しでも興味を持っていただけたらぜひお気軽にご連絡ください。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__c56725f656acc" src="https://embed.zenn.studio/card#zenn-embedded__c56725f656acc" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.crassone.co.jp/recruit/engineer/</a></p>
<section class="footnotes">
<span class="footnotes-title">脚注</span>
<ol class="footnotes-list">
<li id="fn-32da-1" class="footnote-item"><p>コールセンターのメンバーが内部。電話をかける・かけてくる相手が外部という扱いらしいです。 <a href="#fnref-32da-1" class="footnote-backref">↩︎</a></p>
</li>
</ol>
</section>



こんにちは、プロダクト開発部の永元です。

クラッソーネではCTIシステムとしてGenesysを利用しており、管理する顧客情報を連携するためにいくらかハマることがありました。将来の自分のためにも記事として残しておきます。

CTIとは
CTIは、Computer Telephony Integrationの略称です。ざっくり説明すると、所謂コールセンターの業務をサポートするシステムです。詳細に知りたい方はこちらをどうぞ。

Genesysとは
>従来のコールセンターを劇的に進化させる先進のCTIシステム。それが、ジェネシスのコンタクトセンター・ソリューションです。

コンタクトセンター・コールセンターソリューション | オムニチャネル・カスタマーエクスペリエンス | ジェネシス より

GenesysはCTIシステム業界では大手で機能も充実しています。CTIシステムがB向けという性質を持ち、本社がアメリカのサービスなため、大手とは言え日本での認知度は高くなく、公式サイト以外の日本語情報も少ないです。

連絡先の扱い
Genesysでは「外部の連絡先」という名前で顧客情報を扱います。また、「外部の連絡先」には個人と組織が存在します。エンジニアとしてAPIを扱う都合上、日本語訳より英語で覚えることをおすすめします。
外部の連絡先 → external contacts
外部の連絡先(個人) → external contacts(contacts)
外部の連絡先(組織) → external contacts(organizations)

: コールセンターのメンバーが内部。電話をかける・かけてくる相手が外部という扱いらしいです。

ハマりポイント
新しいサービスを利用開始するときは多少ハマるのは当たり前だと思います。ここでは私が特にハマったことを紹介します。

公式ドキュメントページの閲覧に少し慣れが必要
公式ドキュメントは充実しており、うまく検索できれば目的の情報は見つかります。ただ少し慣れが必要です。

公式ドキュメントページはResource CenterとDeveloper Centerと大きく2つに分かれていますが、統一感のあるデザインのため、混同しないように注意しましょう。開発者向けの情報はDeveloper Centerを当たりましょう。Resource Centerの検索ボックスからはサンプルコードなどの開発者が求める情報には辿り着けません。(自戒)

日本語のページもそれなりに存在しますが、英語ページしか存在しないことがよくあるため、最初から英語のページを見るのがおすすめです。

特によく閲覧するページ
External Contacts: 外部連絡先関連のAPI一覧できます。顧客情報に関するAPIはだいたいここを見ればなんとかなります。
Software Development Kit (SDK): 各SDKとそのサンプルコードが一覧できます。
Tutorials: 各環境・言語における様々な利用シーンのチュートリアル(サンプルコード)を一覧できます。自分の目的に近いサンプルが掲載されているととても嬉しいです。
Developer Tools: ブラウザで動作する開発者向けツールです。色んなAPIを試しに呼び出したり、サンプルコードを動かしたりできて便利です。

API利用を始めるためにWEBアプリ上から事前準備が必要
よくある話ではありますが、GenesysでもAPI利用を可能にする事前設定が必要です。利用する認証方法に応じた設定をしましょう。日本語・英語両方のヘルプページを貼っておきますが、APIやその認証方法に詳しい人は英語版だけを読んだほう理解が早いと思います。
Create an OAuth client - Genesys Cloud Resource Center
OAuthクライアントを作成する-Genesysクラウドリソースセンター

GenesysAPIは複数の認証方法に対応しています。次のリンクを参照し、利用シーンに適した認証方法を選びましょう。
https://developer.genesys.cloud/api/rest/authorization/

RubyのSDKがない
厳密には「サポート中のRuby SDKがない」です。
Deprecation: Genesys Cloud Ruby SDK - Genesys Cloud Resource Center
DeprecationですがRuby SDKはGitHubに公開されているので参考にすることは可能です。実際に弊社では参考にして認証部分の実装を行いました。

Rubyにはありませんが、JavaScriptを始め、主要言語で複数種類のSDKが提供されています。公式SDKが豊富なのは非常にありがたいです。

連絡先のバリデーション
外部の連絡先(個人)の場合は姓・名が必須です。姓と名を分けずに管理しているところは対応が必要そうです。
姓: 鈴木一郎
名: .
のように姓と名どちらかにフルネームで設定し、使わない方に意味はなくとも何某かの文字を設定する…といった回避方法はありますが、あまりおすすめしません。Genesysの担当者と自社の状況を踏まえて相談しましょう。

外部の連絡先(組織)の場合は組織名のみ必須です。こちらは特に躓くことはなさそうです。

電話番号の形式
"090xxxxxxxx"
は電話番号として認識されません。電話番号冒頭の0は国内を意味するプレフィックスであり、GenesysのAPI利用時には日本の電話番号であることを明示する必要があるためです。冒頭の"0"を"+81"に置換した"+8190xxxxxxxx"であれば日本の携帯電話番号として認識され、APIから登録が可能です。

ちなみにGenesysのWEBアプリから入力するときは自動的にデフォルトで設定されている国コードに変換して保存してくれます。そのおかげでAPI利用時のエラー原因に気づきにくいです。

※電話番号のプレフィックスなど詳細については総務省｜電気通信番号制度｜電話番号に関するQ&Aの参照をおすすめします

電話番号検索に癖がある
"090xxxxxxxx"
という携帯電話番号について検索したいときは
"90-xxxx-xxxx"
で検索しましょう。

冒頭の国を表すプレフィックスは削除し、ハイフン(全角半角どちらでも可らしい)ありの形式であればHITします。これを知らないと、
「APIで外部の連絡先を作成して200レスポンスだったけど、作成したはずの連絡先が見つからない」
と焦ることになります。(自戒)

また、この仕様はAPIを利用した検索・WEBアプリ上の検索どちらも同じ仕様です。Genesysで電話対応を行うスタッフにこそ、知らせたいです。

最後に
ハマった後に「早く担当者に聞いておけばよかったな。聞いたらすぐ解決してたな。」という反省が私にはありました。Genesysに限らず、新しいツール・サービスの利用を始めるときに多少ハマるのは仕方のないことです。早めに積極的に問い合わせていきたいですね。

We Are Hiring!
クラッソーネに少しでも興味を持っていただけたらぜひお気軽にご連絡ください。

https://www.crassone.co.jp/recruit/engineer/


クラッソーネ開発者ブログ

永元雄宙が執筆した記事

Heroku以外にRailsアプリをデプロイしてみた

エンジニアが１年間の育児休業で感じたこと

Genesys入門時にハマったポイント

永元 雄宙が執筆した記事

Heroku以外にRailsアプリをデプロイしてみた

エンジニアが１年間の育児休業で感じたこと

Genesys入門時にハマったポイント

永元雄宙が執筆した記事