AlertsPanel APIs

inroduction inroduction alertspanel apis allow you to integrate with the platform and create useful functionality around the platform the apis are rest based using json as the standard response type headers api keys need to be added to the authorization header as follows – authorization basic \<authorization key> the api keys can be generated by going to alertspanel api https //app alertspanel com/admin/integrations/platform api section alertspanel apis follow basic authentication utilizing api keys to authenticate the api calls the api keys can be revoked or regenerated at any point in time and would throw authentication errors for the api calls made using them { "tab" "examples", "url" "https //api alertspanel com", "name" "alertspanel apis", "method" "post", "request" { "pathparameters" \[], "queryparameters" \[], "headerparameters" \[], "bodydataparameters" \[], "formdataparameters" \[] }, "results" { "languages" \[ { "id" "keltcmns8tbz5b30bmdy ", "code" "{\n \\"responseobject\\" true\n}", "language" "200", "customlabel" "" }, { "id" "aw tt2mo1dwcgf 4c9xwp", "code" "{\n \\"message\\" \\"ain't no cake like that \\"\n }", "language" "404", "customlabel" "" } ], "selectedlanguageid" "keltcmns8tbz5b30bmdy " }, "examples" { "languages" \[ { "id" "s6zzpicp khm klwsha4f", "language" "curl", "code" "curl location request get 'https //api alertspanel com/bot api/v1 0/customer/61179/bot/bb67e0773bed4c7e/users?attribute name=opt1\&attribute value=yes' \\\\\n header 'authorization basic 2082e8f4 0011 479b 9edb 74293c62d91b gkouziq' \\\\\n header 'content type application/json' \\\\\n data raw ''", "customlabel" "users" }, { "id" "atvkd tpyg doqfof92bz", "language" "curl", "code" "curl location request get 'https //api alertspanel com/bot api/v1 0/customer/61179/bot/bb67e0773bed4c7e/channel user/919565428256/conversations' \\\\\n header 'authorization basic 2082e8f4 0011 479b 9edb 74293c62d91b gkouziq' \\\\\n header 'content type application/json' \\\\\n data raw ''", "customlabel" "conversation history" }, { "id" "ybcwzhfmluyxoadhw1ap ", "language" "curl", "code" "curl location request post 'https //api alertspanel com/whatsapp api/v1 0/customer/49373/bot/f5afdd1c000742f0/template' \\\\\n header 'authorization basic 1b051089 77b5 4a97 ad8e f3186a6a7532 fqxcfmw' \\\\\n header 'content type application/json' \\\\\n data raw '{\n \\"phonenumber\\" \\"+919019486731\\",\n \\"payload\\" {\n \\"components\\" \[\n {\n \\"type\\" \\"header\\",\n \\"parameters\\" \[\n {\n \\"type\\" \\"document\\",\n \\"document\\" {\n \\"filename\\" \\"uribapplicationform 82121086 pdf\\",\n \\"link\\" \\"https //s3 ap south 1 amazonaws com/file upload public/prod/61179/broadcast template attachment/75549 uribapplicationform 82121086 pdf\\"\n }\n }\n ]\n },\n {\n \\"type\\" \\"body\\",\n \\"parameters\\" \[\n {\n \\"type\\" \\"text\\",\n \\"text\\" \\"john\\"\n },{\n \\"type\\" \\"text\\",\n \\"text\\" \\"john\\"\n },{\n \\"type\\" \\"text\\",\n \\"text\\" \\"john\\"\n }\n ]\n },\n {\n \\"index\\" 0,\n \\"parameters\\" \[\n {\n \\"payload\\" \\"flow 7bbb608c3b4b4e848f36cd2ccd7cfa35||data personx response=declined invoice no 12345\\",\n \\"type\\" \\"payload\\"\n }\n ],\n \\"sub type\\" \\"quick reply\\",\n \\"type\\" \\"button\\"\n },\n {\n \\"index\\" 1,\n \\"parameters\\" \[\n {\n \\"payload\\" \\"flow e30d44bcca4c49d49976d3ac0416c405||data personx response=approved invoice no 12345\\",\n \\"type\\" \\"payload\\"\n }\n ],\n \\"sub type\\" \\"quick reply\\",\n \\"type\\" \\"button\\"\n }\n ],\n \\"namespace\\" \\"980c3243 2d2a 4d2d a572 b2a50552cb04\\",\n \\"name\\" \\"renuka sugars paytest\\",\n \\"language\\" {\n \\"policy\\" \\"deterministic\\",\n \\"code\\" \\"en\\"\n }\n }\n}\n}'", "customlabel" "whatsapp broadcast" }, { "id" "fiz3qaxxvf4apscodbx9a", "language" "curl", "code" "curl location request post 'https //api engati com/bot api/v1 0/customer/61179/bot/bb67e0773bed4c7e/flow/default fallback msg 74963' \\\\\n header 'authorization basic 2082e8f4 0011 479b 9edb 74293c62d91b gkouziq' \\\\\n header 'content type application/json' \\\\\n data raw ''", "customlabel" "api triggers" }, { "id" "sje6oda1qufydejy h0y5", "language" "curl", "code" "curl location 'https //api alertspanel com/bot api/v1 0/customer/61179/bot/0ab20e4b037345d0/broadcast' \\\\\n header 'authorization basic 000b0a2a 0231 41ce 81b3 55a6de06fb65 gthkwxy' \\\\\n header 'content type application/json' \\\\\n data '{\n \\"broadcastid\\" null,\n \\"broadcasttitle\\" \\"f1\\",\n \\"publishedon\\" \\"2023 04 04t10 54 00 000z\\",\n \\"audience\\" {\n \\"rule\\" {\n \\"userids\\" \[],\n \\"channeluserids\\" \[\n \\"9178921978038123\\",\\"9190193486731\\"\n ],\n \\"channels\\" \[\n \\"whatsapp\\"\n ]\n }\n },\n \\"payload\\" {\n \\"type\\" \\"whatsapp template\\",\n \\"campaignkey\\" null,\n \\"content\\" \[\n {\n \\"type\\" \\"template\\",\n \\"data\\" null,\n \\"template\\" {\n \\"payload\\" {\n \\"namespace\\" \\"980c3243 2d2a 4d2d a572 b2a50552cb04\\",\n \\"name\\" \\"diwali offer\\",\n \\"components\\" \[\n {\n \\"type\\" \\"body\\",\n \\"parameters\\" \[\n {\n \\"type\\" \\"text\\",\n \\"text\\" \\"john \\"\n },\n {\n \\"type\\" \\"text\\",\n \\"text\\" \\"adam\\"\n }\n ]\n },\n {\n \\"index\\" 0,\n \\"parameters\\" \[\n {\n \\"payload\\" \\"flow welcome 88601\\",\n \\"type\\" \\"payload\\"\n }\n ],\n \\"sub type\\" \\"quick reply\\",\n \\"type\\" \\"button\\"\n },\n {\n \\"index\\" 1,\n \\"parameters\\" \[\n {\n \\"payload\\" \\"flow greetings 88601\\",\n \\"type\\" \\"payload\\"\n }\n ],\n \\"sub type\\" \\"quick reply\\",\n \\"type\\" \\"button\\"\n }\n ],\n \\"namespace\\" \\"980c3243 2d2a 4d2d a572 b2a50552cb04\\",\n \\"name\\" \\"diwali offer\\",\n \\"language\\" {\n \\"code\\" \\"en us\\",\n \\"policy\\" \\"deterministic\\"\n }\n },\n \\"targetwhatsappnumber\\" \\"{{phone no}}\\"\n },\n \\"flowkey\\" null,\n \\"attributes\\" null\n }\n ]\n },\n \\"status\\" \\"scheduled\\"\n}'", "customlabel" "broadcast wrapper api" }, { "id" "ypuxm7 6ubf7e2qokokz9", "language" "yaml", "code" "" }, { "id" "7ituyyedb6lfgepcfhn1s", "language" "xml", "code" "" }, { "id" "jojt 0ihhdgghj7fxxonp", "language" "windows", "code" "" }, { "id" "metgrlwkadwmvaiturott", "language" "vb", "code" "" }, { "id" "webpbfnbdryworwiya3c7", "language" "typescript", "code" "" }, { "id" "xbirc bcl5ylliiequcgb", "language" "text", "code" "" }, { "id" "zr vlvgk 1iufe6mjm vj", "language" "tex", "code" "" }, { "id" "0 onvo8rpp8coy7gcq pr", "language" "tcl", "code" "" }, { "id" "mwnfltarzlkiwbje9cpxm", "language" "swift", "code" "" }, { "id" "odk2v0qakvnzwt3dhvqik", "language" "st", "code" "" }, { "id" "muabc6r8wvtbmp7 exhwc", "language" "sql", "code" "" }, { "id" "dalp3bvpfni7qoi4qydkc", "language" "solidity", "code" "" }, { "id" "bpaakqks0hx3e4rqri37k", "language" "shell", "code" "" }, { "id" "4kltvj8kkvtjus6c mlkq", "language" "scheme", "code" "" }, { "id" "jauch3krwrhekbfthxt0r", "language" "sb", "code" "" }, { "id" "wwnnhbfuecspzmwuzhq c", "language" "rust", "code" "" }, { "id" "ce8kzmrjlydzwcqqgk td", "language" "ruby", "code" "" }, { "id" "u8gpqq1ebgtwa 73rkv8v", "language" "redshift", "code" "" }, { "id" "d3lt9epxhnulzqe5sdrnj", "language" "redis", "code" "" }, { "id" "ggplba6p 5srqwtjtp e ", "language" "razor", "code" "" }, { "id" "25onu28gjnebs2l1kngyu", "language" "r", "code" "" }, { "id" "u82mrkqu71ak68myblkiq", "language" "python", "code" "" }, { "id" " eei3oeipwvfaur2cnmbc", "language" "csharp", "code" "" }, { "id" "mjs2jx2j rwgozt1kxnnj", "language" "csp", "code" "" }, { "id" "ix9azkxmsxcol63ygknys", "language" "css", "code" "" }, { "id" "s8jxqtkgqztmvz6orpoei", "language" "pug", "code" "" }, { "id" "xfalkpun 7hlgak zeizi", "language" "curl", "code" "curl location request post 'https //api alertspanel com' \\\\\n header 'accept application/json' \\\\\n header 'content type application/json'", "customlabel" "" }, { "id" "7xnrcvcp6csza48ycvn52", "language" "nodejs", "code" "var request = require('request');\nvar options = {\n 'method' 'post',\n 'url' 'https //api alertspanel com',\n 'headers' {\n 'accept' 'application/json',\n 'content type' 'application/json'\n }\n};\nrequest(options, function (error, response) {\n if (error) throw new error(error);\n console log(response body);\n});\n", "customlabel" "" }, { "id" "ekhzm5dzl6kj7ww u04ox", "language" "javascript", "code" "var myheaders = new headers();\nmyheaders append(\\"accept\\", \\"application/json\\");\nmyheaders append(\\"content type\\", \\"application/json\\");\n\nvar requestoptions = {\n method 'post',\n headers myheaders,\n redirect 'follow'\n};\n\nfetch(\\"https //api alertspanel com\\", requestoptions)\n then(response => response text())\n then(result => console log(result))\n catch(error => console log('error', error));", "customlabel" "" }, { "id" "rhgoms qa2pryg9xe qmz", "language" "python", "code" "import requests\nimport json\n\nurl = \\"https //api alertspanel com\\"\n\npayload = {}\nheaders = {\n 'accept' 'application/json',\n 'content type' 'application/json'\n}\n\nresponse = requests request(\\"post\\", url, headers=headers, data=payload)\n\nprint(response text)\n", "customlabel" "" }, { "id" "xlyyah6k0cn8iv 3q3qsj", "language" "ruby", "code" "require \\"uri\\"\nrequire \\"json\\"\nrequire \\"net/http\"\n\nurl = uri(\\"https //api alertspanel com\\")\n\nhttps = net http new(url host, url port)\nhttps use ssl = true\n\nrequest = net http post new(url)\nrequest\[\\"accept\\"] = \\"application/json\\"\nrequest\[\\"content type\\"] = \\"application/json\\"\n\nresponse = https request(request)\nputs response read body\n", "customlabel" "" }, { "id" "uf1dn9bvhzppafw qxiaf", "language" "curl", "code" "curl location request post 'https //api alertspanel com' \\\\\n header 'accept application/json' \\\\\n header 'content type application/json'", "customlabel" "" }, { "id" "q87papr5nnt2q j3yy0um", "language" "nodejs", "code" "var request = require('request');\nvar options = {\n 'method' 'post',\n 'url' 'https //api alertspanel com',\n 'headers' {\n 'accept' 'application/json',\n 'content type' 'application/json'\n }\n};\nrequest(options, function (error, response) {\n if (error) throw new error(error);\n console log(response body);\n});\n", "customlabel" "" }, { "id" "wobg6peakqeexklpr gz8", "language" "javascript", "code" "var myheaders = new headers();\nmyheaders append(\\"accept\\", \\"application/json\\");\nmyheaders append(\\"content type\\", \\"application/json\\");\n\nvar requestoptions = {\n method 'post',\n headers myheaders,\n redirect 'follow'\n};\n\nfetch(\\"https //api alertspanel com\\", requestoptions)\n then(response => response text())\n then(result => console log(result))\n catch(error => console log('error', error));", "customlabel" "" }, { "id" "psoq5zdmziin7eoq zgxu", "language" "python", "code" "import requests\nimport json\n\nurl = \\"https //api alertspanel com\\"\n\npayload = {}\nheaders = {\n 'accept' 'application/json',\n 'content type' 'application/json'\n}\n\nresponse = requests request(\\"post\\", url, headers=headers, data=payload)\n\nprint(response text)\n", "customlabel" "" }, { "id" "mtwaikzthp2ytqewlonv ", "language" "ruby", "code" "require \\"uri\\"\nrequire \\"json\\"\nrequire \\"net/http\"\n\nurl = uri(\\"https //api alertspanel com\\")\n\nhttps = net http new(url host, url port)\nhttps use ssl = true\n\nrequest = net http post new(url)\nrequest\[\\"accept\\"] = \\"application/json\\"\nrequest\[\\"content type\\"] = \\"application/json\\"\n\nresponse = https request(request)\nputs response read body\n", "customlabel" "" } ], "selectedlanguageid" "s6zzpicp khm klwsha4f" }, "description" "", "currentnewparameter" { "label" "body parameter", "value" "bodydataparameters" }, "hastryitout" false, "response" \[ { "name" "id", "kind" "optional", "type" "string", "description" "id of the cake retrieved" } ], "autogeneratedanchorslug" "alertspanel apis", "legacyhash" " etybcocdip0wuuimnw69" } users api users api an api to fetch users who match the value specified for the attribute example to get list of users who have feedback with 1 star list of required parameters for this api call parameter description type attribute name the name of the attribute associated with the user string attribute value the value of the attribute associated with the user string conversations api conversations api an api to fetch a user conversation via user id example to store conversation data in crm parameters you can pass to filter the api response parameter description type userid \[path parameter] the user identifier retrieved from users list api string start date \[optional] start date (utc time in milliseconds), if blank, all records will be considered long end date \[optional] end date (utc time in milliseconds), if blank, the current utc time will be considered long page number \[optional] the number of pages for which the data should be displayed by default, the first page will be shown integer page size \[optional] total number of records to be shown in the api call, the default value is set to 500 integer whatsapp template broadcasting for template broadcasting to bulk users on whatsapp note only templates can be sent to users as per whatsapp policy beyond the time limts example apis broadcast api broadcast api to enable and use broadcast wrapper api please contact support\@moplet com for all channels including whatsapp with users within time limit for broadcast a simple text message or interactive messages to bulk users example marketing & advertisments, survey and promotion broadcast will be published based on the time mentioned in utc, immediate broadcasts will be sent for expired time multiple numbers in list format "channeluserids" \[ "9178921978038123","9190193486731" ] api trigger api trigger to trigger automations build on alertspanel platform for external usecases example sending an email to a customer who fills an external website form learn more about broadcasts in depth via api trigger https //help alertspanel com/api triggers document error scenarios error codes you might get while making the api call error codes description 400 error code 1002, error message invalid bot or customer id, error details the bot id/customer id/user id provided is invalid error code 1003, error message invalid input date value, error details the start date and end date values are the time in milliseconds and the end date should be greater than start date error code 1004, error message invalid page number, error details please enter the correct page number the page number in the api is a positive integer value starting with 1 401 unauthorized 403 forbidden 500 server side api failure