{"__v":0,"_id":"5719767ec863120e0012a050","category":{"project":"56008ba98c0c9d0d00dcaeb0","version":"5719767ec863120e0012a042","_id":"582b71b15403840f008c0410","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-11-15T20:36:01.349Z","from_sync":false,"order":2,"slug":"faq","title":"FAQ"},"parentDoc":null,"project":"56008ba98c0c9d0d00dcaeb0","user":"56008b651503430d007cc929","version":{"__v":3,"_id":"5719767ec863120e0012a042","hasDoc":true,"hasReference":true,"project":"56008ba98c0c9d0d00dcaeb0","createdAt":"2016-04-22T00:55:26.295Z","releaseDate":"2016-04-22T00:55:26.295Z","categories":["5719767ec863120e0012a043","5719767ec863120e0012a044","5719767ec863120e0012a045","5719767ec863120e0012a046","5719767ec863120e0012a047","5719767ec863120e0012a048","5719767ec863120e0012a049","57f45a18da14e71700d12e4a","582b71b15403840f008c0410"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-03T23:48:07.602Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"One of the primary benefits of ThisData’s Login Intelligence is that we send notifications to your app’s users when unusual activity is detected on your account.\n\nHowever we only send these emails when certain conditions are met.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"It's turned off by default\"\n}\n[/block]\nWhen you first sign up, we don't send notifications. This allows ThisData time to learn about your users' typical behaviour.\n\nWe'll still generate alerts though, and track unusual behaviour. But this means:\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"You can send your own notifications\"\n}\n[/block]\nIf your pricing plan includes webhooks, you can keep our notifications turned off. Instead, [use webhooks to create your own security workflow](doc:create-a-security-workflow-with-thisdatas-alert-webhooks). You can send the emails, control their content, and request user response.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"How will I know if you're sending notifications?\"\n}\n[/block]\nThe ThisData dashboard shows the number of notifications we are sending. These also appear in the Audit tab. In the Audit tab you can also see any deliverability issues we are running in to. For example, this can occur when the email bounces, or the SMS number is incorrect.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"You need to turn it on\"\n}\n[/block]\nOn your API Settings page, you need to select **\"Yes, send emails\"**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/OERNc2NTE6qhPIwmhjhC_Was%20This%20You%20Email.png\",\n        \"Was This You Email.png\",\n        \"1500\",\n        \"910\",\n        \"#6b63f3\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"You need to send us an email address with EVERY event\"\n}\n[/block]\nIf you want notification via email,  every event you send us must contain an email address. If that event is the one that makes us think something suspicious is happening, we will use that email address as the To address for the email.\n\n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"Allowing Unsubscribes / Turning Email off\",\n  \"body\": \"If you want to have granular control over *which* of your end users we send email to, you can do this by omitting the email address from the event data.\\n\\nThis could allow you to do things like a gradual roll out to X% of your end users, only provide it to your premium customers, or allow your users to unsubscribe from account security emails.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"You need to send us a mobile number with EVERY event\"\n}\n[/block]\nIf you want notification via text message / SMS,  every event you send us must contain an [E.164](https://www.twilio.com/help/faq/phone-numbers/how-do-i-format-phone-numbers-to-work-internationally) formatted mobile phone number. If that event is the one that makes us think something suspicious is happening, we will send an SMS to that mobile number.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Email, SMS, or Both?\"\n}\n[/block]\nWe recommend both. If you send us an email and cellphone number in your event, we will send \"Was This You?\" notifications to both.\n\n**Note:** SMS notifications are only available on our Gold tiers or higher.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Who do the \\\"Was This You?\\\" notifications come from?\"\n}\n[/block]\nExcellent question. Emails are sent from `Your Company Name <security:::at:::thisdata.com>`. Your name and logo are also displayed in the email.\n\nThe API settings page allows you to upload a logo to include in the emails. The name of your ThisData account is used in the email / SMS content.\n\nIf your app is multi-tenanted or you want per-event notification customization, [read about our multi-tenanted application support](doc:multi-tenanted-applications).\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"My app is multi-tenanted - do you support that?\"\n}\n[/block]\nWe support customization of notification emails so that they can appear to come from _your_ customers. [Read about our multi-tenanted application support](doc:multi-tenanted-applications).\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Can I test the notifications?\"\n}\n[/block]\nYes. On the API settings page, there are _\"Save and Send Test Email\"_ or _\"Test SMS\"_ buttons, which allow you to preview your messages.","excerpt":"Wondering when we will send \"Was This You\" notifications? Or want to turn it off / on? Read on!","slug":"was-this-you-notifications-when-and-where","type":"basic","title":"\"Was This You?\" notifications. When and Where?"}

"Was This You?" notifications. When and Where?

Wondering when we will send "Was This You" notifications? Or want to turn it off / on? Read on!

One of the primary benefits of ThisData’s Login Intelligence is that we send notifications to your app’s users when unusual activity is detected on your account. However we only send these emails when certain conditions are met. [block:api-header] { "type": "basic", "title": "It's turned off by default" } [/block] When you first sign up, we don't send notifications. This allows ThisData time to learn about your users' typical behaviour. We'll still generate alerts though, and track unusual behaviour. But this means: [block:api-header] { "type": "basic", "title": "You can send your own notifications" } [/block] If your pricing plan includes webhooks, you can keep our notifications turned off. Instead, [use webhooks to create your own security workflow](doc:create-a-security-workflow-with-thisdatas-alert-webhooks). You can send the emails, control their content, and request user response. [block:api-header] { "type": "basic", "title": "How will I know if you're sending notifications?" } [/block] The ThisData dashboard shows the number of notifications we are sending. These also appear in the Audit tab. In the Audit tab you can also see any deliverability issues we are running in to. For example, this can occur when the email bounces, or the SMS number is incorrect. [block:api-header] { "type": "basic", "title": "You need to turn it on" } [/block] On your API Settings page, you need to select **"Yes, send emails"**. [block:image] { "images": [ { "image": [ "https://files.readme.io/OERNc2NTE6qhPIwmhjhC_Was%20This%20You%20Email.png", "Was This You Email.png", "1500", "910", "#6b63f3", "" ], "sizing": "full" } ] } [/block] [block:api-header] { "type": "basic", "title": "You need to send us an email address with EVERY event" } [/block] If you want notification via email, every event you send us must contain an email address. If that event is the one that makes us think something suspicious is happening, we will use that email address as the To address for the email. [block:callout] { "type": "success", "title": "Allowing Unsubscribes / Turning Email off", "body": "If you want to have granular control over *which* of your end users we send email to, you can do this by omitting the email address from the event data.\n\nThis could allow you to do things like a gradual roll out to X% of your end users, only provide it to your premium customers, or allow your users to unsubscribe from account security emails." } [/block] [block:api-header] { "type": "basic", "title": "You need to send us a mobile number with EVERY event" } [/block] If you want notification via text message / SMS, every event you send us must contain an [E.164](https://www.twilio.com/help/faq/phone-numbers/how-do-i-format-phone-numbers-to-work-internationally) formatted mobile phone number. If that event is the one that makes us think something suspicious is happening, we will send an SMS to that mobile number. [block:api-header] { "type": "basic", "title": "Email, SMS, or Both?" } [/block] We recommend both. If you send us an email and cellphone number in your event, we will send "Was This You?" notifications to both. **Note:** SMS notifications are only available on our Gold tiers or higher. [block:api-header] { "type": "basic", "title": "Who do the \"Was This You?\" notifications come from?" } [/block] Excellent question. Emails are sent from `Your Company Name <security@thisdata.com>`. Your name and logo are also displayed in the email. The API settings page allows you to upload a logo to include in the emails. The name of your ThisData account is used in the email / SMS content. If your app is multi-tenanted or you want per-event notification customization, [read about our multi-tenanted application support](doc:multi-tenanted-applications). [block:api-header] { "type": "basic", "title": "My app is multi-tenanted - do you support that?" } [/block] We support customization of notification emails so that they can appear to come from _your_ customers. [Read about our multi-tenanted application support](doc:multi-tenanted-applications). [block:api-header] { "type": "basic", "title": "Can I test the notifications?" } [/block] Yes. On the API settings page, there are _"Save and Send Test Email"_ or _"Test SMS"_ buttons, which allow you to preview your messages.