Doyouok (Preview)
Doyouok monitors scheduled jobs and automations. Report the result of each flow run, and Doyouok alerts you by email, Telegram, Slack or Discord when a run fails or doesn't happen on time.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Doyouok Support |
| URL | https://doyouok.com |
| admin@doyouok.com |
| Connector Metadata | |
|---|---|
| Publisher | GCESoftware Pty Ltd |
| Website | https://doyouok.com |
| Privacy policy | https://doyouok.com/home/privacy |
| Categories | IT Operations;Productivity |
Doyouok
Doyouok alerts you by email, Telegram, Slack or Discord when a flow run fails, returns the wrong result, or doesn't run at all. Built-in failure emails pause for 28 days after an alert and don't cover a flow that stops being triggered; Doyouok expects a report on every run and alerts you when one is missing.
Choose how to report runs
| This connector | ||
|---|---|---|
| License | Any. Send an email (V2) of Office 365 Outlook (work accounts) or Outlook.com (personal accounts) is a Standard connector | Premium, like every certified third-party connector |
| Check | Create it on doyouok.com first | Created by the first run, by name |
| Speed | Usually seconds, sometimes minutes | Immediate |
| Failure reason | Email body | Failure reason field |
Without a Premium license, use email; see Report runs by email. With Premium, use Report a run below.
Publisher: GCESoftware Pty Ltd
Prerequisites
- A Doyouok account. Sign up at doyouok.com. The Free plan includes 5 checks. Starter includes 50 checks for $5/month.
- An API token. In Doyouok, open Profile > API tokens and create one. It starts with
dyo_.
Supported Operations
Report a run
Reports one run (success or failure) to a check.
- Check name: the first run creates the check, and later runs with the same name report to it. A new name creates a new check.
- Expected interval (minutes): how often the flow runs, for example
60for hourly or1440for daily. Doyouok alerts you when no report arrives within this time. - Existing check (advanced): a check created on doyouok.com or by this connector. When it is set, the check name and interval are ignored.
- Result:
SuccessorFailure. A mapped value also works:success,true,ok,yesor1reports a success;fail,false,error,failed,noor0reports a failure. - Failure reason: saved with a failure report and shown in the alert, for example
0 rows imported.
The first run of a new check takes up to about 20 seconds longer while the check is activated.
Obtaining Credentials
Sign in to doyouok.com, open Profile > API tokens, create a token and paste it into the API token field of the connection.
Getting Started
- Add Report a run as the last step of your flow, with Result set to
Success. - To report failures, add a second Report a run with Result set to
Failure, and use Configure run after so it runs only when an earlier step has failed or timed out. Use the same check name in both steps. - Set Expected interval to how often the flow runs. If the flow stops running, Doyouok alerts you when the interval passes without a report.
Report runs by email (no Premium license)
- On doyouok.com, create a check with an interval a few minutes longer than the flow's schedule (Doyouok alerts as soon as the interval passes), then copy its ping URL, for example
https://ping.doyouok.com/ping/<key>. - At the end of the flow, add a Condition. In the yes branch, add Send an email (V2) to
ping@doyouok.comwith the subjectsuccessfollowed by the ping URL (or just the key at its end). In the no branch, sendping@doyouok.coman email with the subjectfailfollowed by the ping URL, and the reason in the body. - To report a step that failed or timed out, add a
failemail and use Configure run after on it.
The subject must contain the key or ping URL; otherwise the email bounces. Apart from that, the subject's first word sets the result, case-insensitive: success, ok, true, yes or 1 reports a success; fail, failed, error, false, no or 0 reports a failure. Other subjects report the run without a result. The failure reason is the first 2,000 characters of the body.
- Email usually arrives within seconds but can be delayed by minutes, so keep those extra minutes in the interval.
- An unknown key is rejected and the email bounces back to the sender. A new check accepts email after about 10 seconds.
- Send one email per run. Emails for the same check less than a second apart are counted as one.
- Some organizations block email to external addresses.
Known Issues and Limitations
- Renaming a check in the step creates a new check; the old one stops receiving reports and alerts as missed.
- Each run makes two requests to Doyouok. The API allows 120 requests per minute per token.
API Documentation
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| API token | securestring | An API token from Doyouok Profile > API tokens. It starts with dyo_. | True |
Actions
| Report a run |
Reports the result of this flow run to Doyouok, which alerts you when a run fails or is missed. |
Report a run
Reports the result of this flow run to Doyouok, which alerts you when a run fails or is missed.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Check name
|
checkName | string |
The check to report to, for example Nightly sync. The first run creates the check and later runs with the same name report to it. Leave it empty when you choose an existing check. |
|
|
Expected interval (minutes)
|
intervalMinutes | integer |
How often this flow runs, for example 60 for hourly or 1440 for daily. Doyouok alerts you when no report arrives within this time. |
|
|
Existing check
|
checkId | string |
A check created on doyouok.com or by this connector. When you choose one, the check name and interval are ignored. |
|
|
Result
|
result | True | string |
The result of this run. A mapped value also works: success, true, ok, yes or 1 reports a success, and fail, false, error, failed, no or 0 reports a failure. |
|
Failure reason
|
failureReason | string |
Saved with a failure report and shown in the alert, for example 0 rows imported. |
Returns
- Body
- ReportRunResult
Definitions
ReportRunResult
| Name | Path | Type | Description |
|---|---|---|---|
|
Check ID
|
checkId | string |
The ID of the check that received the report. |
|
Check name
|
name | string |
The name of the check that received the report. |
|
Reported result
|
status | string |
The reported result, success or fail. |
|
Check created
|
created | boolean |
True when this run created the check. |