{"id":17502,"date":"2023-01-31T19:47:00","date_gmt":"2023-01-31T10:47:00","guid":{"rendered":"https:\/\/docs.c-bot.pro\/?p=17502"},"modified":"2023-05-28T22:26:15","modified_gmt":"2023-05-28T13:26:15","slug":"for_developers","status":"publish","type":"post","link":"https:\/\/docs.c-bot.pro\/en\/user_guide\/for_developers\/","title":{"rendered":"For developers"},"content":{"rendered":"\n<p><a href=\"https:\/\/docs.c-bot.pro\/en\/\"><i class=\"fas fa-book\"><\/i>&nbsp;Home<\/a> &gt; <a href=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/\">User guide<\/a> &gt; For developers<\/p>\n\n\n\n<h2 id=\"outline__1\" class=\"wp-block-heading\">Introduction<\/h2>\n\n\n\n<p>Transition from \"For Developers\" in the global menu.<\/p>\n\n\n\n<p>With the developer functions, you can make settings for calling BOTs created in the cloud BOT as APIs, execution tests, and advanced settings related to cooperation with external services.<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"774\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2023\/05\/for_developer_en-1024x774.png\" alt=\"\" class=\"wp-image-20863\"\/><\/figure>\n\n\n\n<h2 id=\"outline__2\" class=\"wp-block-heading\">API<\/h2>\n\n\n\n<p>The created BOT can be published as an API.<\/p>\n\n\n\n<h3 id=\"outline__2_1\" class=\"wp-block-heading\">Basic settings<\/h3>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"792\" height=\"326\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2022\/06\/api_scr_en_02-1.jpg\" alt=\"\" class=\"wp-image-10098\"\/><\/figure>\n\n\n\n<p>Sets a public path (ID) and enable the API. The public ID you set will be used as part of the endpoint when calling the BOT.<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"792\" height=\"326\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2022\/06\/api_scr_en_03-1.jpg\" alt=\"\" class=\"wp-image-10100\"\/><\/figure>\n\n\n\n<p>When the API is published, \"Disable API\" is displayed to disable the API.<\/p>\n\n\n\n<h3 id=\"outline__2_2\" class=\"wp-block-heading\">API List<\/h3>\n\n\n\n<p>You need to enable the API in advance. In addition, public settings must be set for each BOT. The public ID you set will be used as part of the endpoint when calling the BOT.<\/p>\n\n\n\n<p>By switching tabs, currently published BOTs and unpublished BOTs are displayed alternatively.<\/p>\n\n\n\n<h4 id=\"outline__2_2_1\" class=\"wp-block-heading\">Publishing your BOT as API<\/h4>\n\n\n\n<p>BOT is set to \"Private\" by default.<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"718\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2022\/06\/api_scr_en_07-1024x718.jpg\" alt=\"\" class=\"wp-image-10087\"\/><\/figure>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Select the [Private] tab.<\/li>\n\n\n\n<li>Press the [Publish] button of the BOT whose API you want to publish.<\/li>\n\n\n\n<li>Click the [Publish your API] button.<\/li>\n\n\n\n<li>Click [OK] in the modal window.<\/li>\n<\/ol>\n\n\n\n<h4 id=\"outline__2_2_2\" class=\"wp-block-heading\">About API<\/h4>\n\n\n\n<p>You can view the information such as about BOT, Public settings, Endpoint.<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"865\" height=\"1024\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2022\/06\/api_scr_en_08-865x1024.jpg\" alt=\"\" class=\"wp-image-10088\"\/><\/figure>\n\n\n\n<h5 id=\"outline__2_2_2_1\" class=\"wp-block-heading\">Enable\/Disable API<\/h5>\n\n\n\n<p>You can enable\/disable it with the button in the \"Public Settings\".<a href=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/for_developers\/#outline__2_1\" data-type=\"URL\" data-id=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/for_developers\/#outline__2_1\"> It is same as the button in the \"Basic settings\".<\/a><\/p>\n\n\n\n<h5 id=\"outline__2_2_2_2\" class=\"wp-block-heading\">Testing API Using API Test Tool<\/h5>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>You can actually run the BOT API using the test tool.<\/p>\n\n\n\n<p>Scroll down the About API screen to test three types: BOT Execution (POST), Job Reference (GET), and Job Suspension (DELETE).<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Here, we explain the steps with using \"BOT Execution\" as an example.<\/p>\n\n\n\n<p>The Request Body shows the parameter sample used when executing the BOT API. The sample is created with the initial values in the BOT.<br>It is possible to rewrite the Request Body and test the execution.<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Select the access token to be used and enter the secret key.<\/li>\n\n\n\n<li>Click [Send] to execute the API.<\/li>\n\n\n\n<li>When the API execution is completed, the response contents will be displayed in \"Response Body\".<\/li>\n<\/ol>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"885\" height=\"1024\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2022\/06\/api_scr_en_09-885x1024.jpg\" alt=\"\" class=\"wp-image-10089\"\/><\/figure>\n<\/div>\n<\/div>\n\n\n\n<h2 id=\"outline__3\" class=\"wp-block-heading\">Event Hook<\/h2>\n\n\n\n<p>A setting to notify the specified callback when a specific event occurs.<\/p>\n\n\n\n<h3 id=\"outline__3_1\" class=\"wp-block-heading\">BOT Event<\/h3>\n\n\n\n<p>A list of event hooks set in BOT will be displayed.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>You can register, edit and delete it.<\/li>\n<\/ul>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"193\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2023\/05\/event_hooks_en-1024x193.png\" alt=\"\" class=\"wp-image-20865\"\/><\/figure>\n\n\n\n<h4 id=\"outline__3_1_1\" class=\"wp-block-heading\">Register or edit an event hook<\/h4>\n\n\n\n<p>You can register event hooks to any BOT. The same operation will be performed when you press \"Edit\" from the list.<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"637\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2022\/08\/\u30b9\u30af\u30ea\u30fc\u30f3\u30b7\u30e7\u30c3\u30c8-2022-08-22-13.03.30-1024x637.png\" alt=\"\" class=\"wp-image-11125\"\/><\/figure>\n\n\n\n<h5 id=\"outline__3_1_1_1\" class=\"wp-block-heading\">Target BOT<\/h5>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Select the BOT that will be the condition for triggering the event.<\/li>\n<\/ul>\n\n\n\n<h5 id=\"outline__3_1_1_2\" class=\"wp-block-heading\">Event<\/h5>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Specifies the condition for triggering the event.<\/li>\n<\/ul>\n\n\n\n<h5 id=\"outline__3_1_1_3\" class=\"wp-block-heading\">Callback Type<\/h5>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Select the callback type.\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/for_developers\/#outline__3_1_2_1\" data-type=\"URL\" data-id=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/for_developers\/#outline__3_1_2_1\">Webhook<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/for_developers\/#outline__3_1_2_2\" data-type=\"URL\" data-id=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/for_developers\/#outline__3_1_2_2\">Mailhook<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<h5 id=\"outline__3_1_1_4\" class=\"wp-block-heading\">Language<\/h5>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Select the language.<\/li>\n<\/ul>\n\n\n\n<h5 id=\"outline__3_1_1_5\" class=\"wp-block-heading\">Enable\/disable event hook<\/h5>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Enable the event hook by checking the checkbox. Uncheck to disable.<\/li>\n\n\n\n<li>You can check the status is enabled or disabled in the list of event hooks.<\/li>\n<\/ul>\n\n\n\n<div style=\"height:50px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 id=\"outline__3_1_2\" class=\"wp-block-heading\">About the callback type<\/h4>\n\n\n\n<h5 id=\"outline__3_1_2_1\" class=\"wp-block-heading\">Webhook<\/h5>\n\n\n\n<p><small>When an event occurs, the BOT execution result will be posted to the endpoint.<\/small><\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"127\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2022\/08\/\u30b9\u30af\u30ea\u30fc\u30f3\u30b7\u30e7\u30c3\u30c8-2022-08-22-13.04.25-1024x127.png\" alt=\"\" class=\"wp-image-11126\"\/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Enter your endpoint.<\/li>\n<\/ul>\n\n\n\n<p><small>*The endpoint must always start with https:\/\/.<br>\n*Please refer to \u300c<a href=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2022\/05\/callback-v4-en.html\" target=\"_blank\" rel=\"noopener\">Cloud BOT RESTful API Callback Endpoint Implementation Requirements<\/a>\u300d for endpoint implementation requirements.<br>\n\u203bPlease refer <a href=\"https:\/\/resources.c-bot.pro\/source_ip_addresses.txt\" target=\"_blank\" rel=\"noopener\">here<\/a> for the request source IP address of the webhook.<\/small><\/p>\n\n\n\n<h5 id=\"outline__3_1_2_2\" class=\"wp-block-heading\">Mailhook<\/h5>\n\n\n\n<p><small>When an event occurs, the BOT execution result will be sent to the specified email address.<\/small><\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"354\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2022\/08\/\u30b9\u30af\u30ea\u30fc\u30f3\u30b7\u30e7\u30c3\u30c8-2022-08-22-13.05.30-1024x354.png\" alt=\"\" class=\"wp-image-11127\"\/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Select the email address to send. (Multiple selection possible)<\/li>\n<\/ul>\n\n\n\n<p><small>* You can select email addresses for members and guests in Member Management. <a href=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/members\/\">Please refer to the member management page.<\/a>\n<\/small><\/p>\n\n\n\n<h2 id=\"outline__4\" class=\"wp-block-heading\">OAuth 2.0<\/h2>\n\n\n\n<p>By using OAuth authentication, users will be able to authorize access to external applications with their own account privileges without being aware of specialized settings such as access tokens and secret keys.<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"118\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2023\/05\/OAuth_en-1024x118.png\" alt=\"\" class=\"wp-image-20866\"\/><\/figure>\n\n\n\n<h3 id=\"outline__4_1\" class=\"wp-block-heading\">My Apps<\/h3>\n\n\n\n<p>Displays the registered apps. You can set the setting which allows external applications to be authorized via OAuth authentication.<\/p>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ul class=\"wp-block-list\">\n<li>You can register, edit or discard apps.<\/li>\n<\/ul>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Click the [Add a New App] button to display a modal window. Enter the app name and the callback URL.<\/li>\n<\/ul>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Be sure to set your company name or personal name before adding My Apps.<\/li>\n<\/ul>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"477\" height=\"455\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2022\/06\/api_scr_en_12.jpg\" alt=\"\" class=\"wp-image-10092\"\/><\/figure>\n<\/div>\n<\/div>\n\n\n\n<h2 id=\"outline__5\" class=\"wp-block-heading\">Documents<\/h2>\n\n\n\n<p><a href=\"https:\/\/docs.c-bot.pro\/en\/api_reference\/\" data-type=\"URL\" data-id=\"https:\/\/docs.c-bot.pro\/en\/api_reference\/\">Refer to this page for API references.<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>&nbsp;Home &gt; User guide &gt; For developers Introduction Transition from \"For Developers\" in the global menu. With the developer functions, you can make settings for calling BOTs created in the cloud BOT as APIs, execution tests, and advanced settings related to cooperation with external services. API The created BOT can be published as an API. Basic settings Sets a public path (ID) and enable the API. The public ID you set will be used as part of the endpoint when calling the BOT. When the API is published, \"Disable API\" is displayed to disable the API. API List You need to enable the API in advance. In addition, public settings must be set for each BOT. The public ID you set will be used as part of the endpoint when calling the BOT. By switching tabs, currently published BOTs and unpublished BOTs are displayed alternatively. Publishing your BOT as API BOT is set to \"Private\" by default. About API You can view the information such as about BOT, Public settings, Endpoint. Enable\/Disable API You can enable\/disable it with the button in the \"Public Settings\". It is same as the button in the \"Basic settings\". Testing API Using API Test Tool [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_locale":"en_US","_original_post":"https:\/\/docs.c-bot.pro\/?p=8048","footnotes":""},"categories":[28],"tags":[],"class_list":["post-17502","post","type-post","status-publish","format-standard","hentry","category-user_guide","en-US"],"_links":{"self":[{"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/posts\/17502","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/comments?post=17502"}],"version-history":[{"count":9,"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/posts\/17502\/revisions"}],"predecessor-version":[{"id":20867,"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/posts\/17502\/revisions\/20867"}],"wp:attachment":[{"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/media?parent=17502"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/categories?post=17502"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/tags?post=17502"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}