{"__v":1,"_id":"5845a4aa9f6fbb1b0043081f","category":{"version":"5845a4a89f6fbb1b004307b7","project":"54d3007669578e0d002730c9","_id":"5845a4a89f6fbb1b004307be","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-07-30T07:08:52.789Z","from_sync":false,"order":6,"slug":"domains","title":"Domains"},"parentDoc":null,"project":"54d3007669578e0d002730c9","user":"55bafe141b0d663700781682","version":{"__v":1,"_id":"5845a4a89f6fbb1b004307b7","project":"54d3007669578e0d002730c9","createdAt":"2016-12-05T17:32:24.708Z","releaseDate":"2016-12-05T17:32:24.708Z","categories":["5845a4a89f6fbb1b004307b8","5845a4a89f6fbb1b004307b9","5845a4a89f6fbb1b004307ba","5845a4a89f6fbb1b004307bb","5845a4a89f6fbb1b004307bc","5845a4a89f6fbb1b004307bd","5845a4a89f6fbb1b004307be","5845a4a89f6fbb1b004307bf","5845a4a89f6fbb1b004307c0"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"25.0.0","version":"25"},"updates":["588a534fa1592e1b004508dd"],"next":{"pages":[],"description":""},"createdAt":"2015-08-04T08:36:49.086Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":5,"body":"[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"This domain is supported in the following languages:\\n* English\\n* Italian\\n* Japanese\"\n}\n[/block]\n* [Contacts: Calls](#contacts-calls)\n* [Contacts: Emails](#contacts-emails)\n* [Contacts: Messages](#contacts-messages)\n* [Contacts: Nicknames](#contacts-nicknames)\n* [Contacts: Manage](#contacts-manage)\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Contacts: Calls\"\n}\n[/block]\n## Call / Dial\n\n### Action\n\nName| Description  \n---|---  \ncall.call| Requests to call a number, contact or venue  \ncall.dial| Requests to dial a number, contact or venue  \n  \n### Data\n\nName| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---  \nq| string| optional| Defines the unknown query. </br>Can be _my number_ if user asks to call his own number.| Call ewqewq. (q=ewqewq) <br> Dial my phone number. (q=my number)  \nnumber| string| optional| Defines the number.| Call 5555. (number=5555)  \nphone_type| string| optional| Defines the phone type. </br>_See the list of available values_:  </br>[Phone Type List](#section-phone-type-list) | Call John on mobile number. (phone_type=mobile)  \ncall_type| string| optional| Defines the call type. </br>_See the list of available values_: </br>[Call Type List](#section-call-type-list) | Call last number I called. (call_type=outgoing) <br> Dial my last missed call. (call_type=missed)  \nname_first| string| optional| Defines the first name| Call John. (name_first=John)  \nname_last| string| optional| Defines the last name| Call John Smith. (name_last=Smith)  \nvenue_title| string| optional| Defines the venue name| Call Empire State Building. (venue_title=Empire State Building)  \nvenue_chain| string| optional| Defines the venue chain| Call Starbucks. (venue_chain=Starbucks)  \nvenue_type| string| optional| Defines the venue type| Call restaurant. (venue_type=restaurant)  \n  \n## Call Back / Redial\n\n### Action\n\nName| Description  \n---|---  \ncall.call_back| Requests to call back  \ncall.redial| Requests to redial  \n  \n### Data\n\nName| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---  \nq| string| optional| Defines the unknown query. </br>Can be _my number_ if user asks to call his own number. | Call ewqewq back. (q=ewqewq) <br> Redial my home number. (q=my number)  \nnumber| string| optional| Defines the number| Redial 5555. (number=5555)  \nphone_type| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list)| Call John again on mobile number. (phone_type=mobile)  \ncall_type| string| optional| Defines the call type. </br>_See the list of available values_: </br>[Call Type List](#section-call-type-list)| Redial last number I called. (call_type=outgoing) <br> Call back my last missed call. (call_type=missed)  \nname_first| string| optional| Defines the first name| Call John again. (name_first=John)  \nname_last| string| optional| Defines the last name| Call back John Smith. (name_last=Smith)  \nvenue_title| string| optional| Defines the venue name| Call Empire State Building again. (venue_title=Empire State Building)  \nvenue_chain| string| optional| Defines the venue chain| Call Starbucks again. (venue_chain=Starbucks)  \nvenue_type| string| optional| Defines the venue type| Call restaurant again. (venue_type=restaurant)  \n  \n## Call: Answer\n\n### Action\n\nName| Description  \n---|---  \ncall.answer| Specifies how to answer incoming call  \n  \n### Data\n\nName| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---  \nspeaker| string| optional| Defines whether to use speaker or no.</br>Available values: _on_, _off_ | Answer call with speaker off. (speaker=off)  \nvideo| string| optional| Defines whether to use video or no.</br>Available values: _on_, _off_| Answer call with video. (video=on)  \n  \n## Call: Get\n\n### Action\n\nName| Description  \n---|---  \ncall.contact_get| Requests to know who is calling at the moment  \n  \n## Call: End\n\n### Action\n\nName| Description  \n---|---  \ncall.end| Requests to end the call  \n  \n## Call: Search\n\n### Action\n\nName| Description  \n---|---  \ncall.search| Requests to search for recent calls  \n  \n### Data\n\nName| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---  \ncall_type| string| optional| Defines the call type. </br>_See the list of available values_: </br>[Call Type List](#section-call-type-list)| Last number I called. (call_type=outgoing) <br> Show my last missed call. (call_type=missed)  \n  \n## Call: Confirm: On\n\n### Action\n\nName| Description  \n---|---  \ncall.confirm_on| Requests to confirm before calling  \n  \n## Call: Confirm: Off\n\n### Action\n\nName| Description  \n---|---  \ncall.confirm_off| Requests not to confirm before calling  \n  \n## Call: Voicemail\n\n### Action\n\nName| Description  \n---|---  \ncall.voicemail| Requests to check voicemail  \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Contacts: Emails\"\n}\n[/block]\n## Email: Write\n\n### Action\n\nName| Description  \n---|---  \nemail.write| Requests to compose an email  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \nrecipient| _data_| list of objects| optional| | \nrecipient_name| _recipient_| string| required| Defines the name of the recipient.| Email John. (recipient_name=John)  \nrecipient_address| _recipient_| string| optional| Defines the address of the recipient.| Email john:::at:::speaktoit.com (recipient_address=john@speaktoit.com)  \nemail_type| _recipient_| string| optional| Defines the type of email. </br>_See the list of all available values_: </br>[Email Type List](#section-email-type-list) | Email John's work address. (email_type=work)  \nmessage| _data_| string| optional| Defines the text of the email.| Email John how are you. (message=how are you)  \nsubject | _data_| string| optional| Defines the subject of the email| Email subject hello message how are you. (subject=hello)  \nq| _data_| string| optional| Defines the part of the phrase which is hard to determine whether it's name of the recipeint or the text to send.| Email Hello how are you? (q=Hello)  \n  \n## Email: Forward\n\n### Action\n\nName| Description  \n---|---  \nemail.forward| Requests to forward an email  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \nrecipient| _data_| list of objects| optional| Defines the name of the recipient. </br>Can be _all _if user requested all contacts.| Forward email to all my contacts. (recipient=all)  \nrecipient_name| _recipient_| string| required| Defines the name of the recipient.| Forward email to John. (recipient_name=John)  \nrecipient_address| _recipient_| string| optional| Defines the address of the recipient.| Forward email to john@speaktoit.com (recipient_address=john@speaktoit.com)  \nsender| _data_| list of objects| optional| |  \nsender_name| _sender_| string| required| Defines the name of the sender.| Forward email from John. (sender_name=John)  \nsender_address| _sender_| string| optional| Defines the address of the sender.| Forward email from john@speaktoit.com (sender_address=john@speaktoit.com)  \nmessage| _data_| string| optional| Defines the text of the email.| Resend email how are you to John. (message=how are you)  \nsubject| _data_| string| optional| Defines the subject of the email.| Resend email with subject hello (subject=hello)  \n  \n## Email: Reply\n\n### Action\n\nName| Description  \n---|---  \nemail.reply| Requests to reply to an email  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \nsender| _data_| list of objects| optional| |  \nsender_name| _sender_| string| required| Defines the name of the sender.| Reply to mail from John. (sender_name=John)  \nsender_address| _sender_| string| optional| Defines the address of the sender.| Reply to john@speaktoit.com email. (sender_address=john@speaktoit.com)  \nemail_type| _recipient_| string| optional| Defines the type of email. </br>_See the list of all available values_: </br>[Email Type List](#section-email-type-list)| Reply to John's work address. (email_type=work)  \nmessage| _data_| string| optional| Defines the text of the email.| Reply to email from John thank you. (message=thank you.)  \nsubject| _data_| string| optional| Defines the subject of the email.| Reply to email with subject hello (subject=hello)  \n  \n## Email: Read\n\n### Action\n\nName| Description  \n---|---  \nemail.read| Requests to read emails  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \nfolder| _data_| string| optional| Defines the folder to search.| Read emails from folder travel (folder=travel)  \nunread| _data_| string| optional| Defines request to find unread emails. </br>Available values: _true _| Read new email. (unread=true)  \nrecipient| _data_| list of objects| optional| | \nrecipient_name| _recipient_| string| required| Defines the name of the recipient.| Read mails to John. (recipient_name=John)  \nrecipient_address| _recipient_| string| optional| Defines the address of the recipient.| Read my mails to john@speaktoit.com (recipient_address=john@speaktoit.com)  \nsender| _data_| list of objects| optional| |  \nsender_name| _sender_| string| required| Defines the name of the sender.| Read email from John. (sender_name=john)  \nsender_address| _sender_| string| optional| Defines the address of the sender.| Read email from john@speaktoit.com (sender_address=john@speaktoit.com)  \nmessage| _data_| string| optional| Defines the text of the email.| Read emails with text how are you (message=how are you)  \nsubject| _data_| string| optional| Defines the subject of the email.| Read emails with subject hello (subject=hello)  \n  \n## Email: Check\n\n### Action\n\nName| Description  \n---|---  \nemail.check| Requests to check emails  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \nfolder| _data_| string| optional| Defines the folder to search.| Check email from folder travel (folder=travel)  \nunread| _data_| string| optional| Defines request to check for unread emails. </br>Available values: _true _| Any new emails? (unread=true)  \nrecipient| _data_| list of objects| optional| | \nrecipient_name| _recipient_| string| required| Defines the name of the recipient.| Check my mails to John. (recipient_name=John)  \nrecipient_number| _recipient_| string| optional| Defines the number of the recipient.| Check mails to john@speaktoit.com (sender_address=john@speaktoit.com)  \nsender| _data_| list of objects| optional| |  \nsender_name| _sender_| string| required| Defines the name of the sender.| Do I have mails from John? (sender_name=John)  \nsender_address| _sender_| string| optional| Defines the address of the sender.| Any new mails from john@speaktoit.com (sender_address=john@speaktoit.com)  \nmessage| _data_| string| optional| Defines the text of the email.| Do I have any mails with text hello (message=hello)  \nsubject| _data_| string| optional| Defines the subject of the email.| Do I have any mails with subject hello (subject=hello)  \n  \n## Email: Notify: On\n\n### Action\n\nName| Description  \n---|---  \nemail.notify_on| Requests to notify about new emails  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \nfolder| _data_| string| optional| Defines the folder to search| Notify about new emails from folder travel (folder=travel)  \nsender| _data_| list of objects| optional| |  \nsender_name| _sender_| string| required| Defines the name of the sender| Notify about new emails from John. (sender_name=John)  \nsender_address| _sender_| string| optional| Defines the address of the sender| Notify about new emails from john@speaktoit.com (sender_address=john@speaktoit.com)  \nmessage| _data_| string| optional| Defines the message of the email| Notify about new emails containing hello how are you (message=hello how are you)  \nunread| _data_| string| optional| Defines request to find unread emails. </br>Available values: _true _| Notify about new emails. (unread=true)  \n  \n## Email: Notify: Off\n\n### Action\n\nName| Description  \n---|---  \nemail.notify_off| Requests not to notify about new emails  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \nfolder| _data_| string| optional| Defines the folder to search| Don't notify about new emails from folder travel (folder=travel)  \nsender| _data_| list of objects| optional| |  \nsender_name| _sender_| string| required| Defines the name of the sender| Don't notify about new emails from John. (sender_name=John)  \nsender_address| _sender_| string| optional| Defines the address of the sender| Don't notify about new emails from john@speaktoit.com (sender_address=john@speaktoit.com)  \nmessage| _data_| string| optional| Defines the message of the email| Don't notify about new emails containing hello how are you (message=hello how are you)  \nunread| _data_| string| optional| Defines request to find unread emails. </br>Available values: _true _| Don't notify about new emails. (unread=true) \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Contacts: Messages\"\n}\n[/block]\n## Messages: Write\n\n### Action\n\nName| Description  \n---|---  \nmessages.write| Requests to compose a message  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \nrecipient| _data_| list of objects| optional| | \nrecipient_name| _recipient_| string| required| Defines the name of the recipient.| Message John. (recipient_name=John)  \nrecipient_number| _recipient_| string| optional| Defines the number of the recipient.| Message +7(999)555-33-22 (recipient_number=+79995553322)  \nphone_type| _recipient_| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list)| Message John on mobile. (phone_type=mobile)  \nmessage| _data_| string| optional| Defines the text of the message.| Message John How are you? (message=How are you?)  \nq| _data_| string| optional| Defines the part of the phrase which is hard to determine whether it's name of the recipeint or the text to send.| Message Hello how are you? (q=Hello)  \nservice| _data_| string| optional| Defines the service to use. </br>_See the list of all available values_: </br>[Service List](#section-service-list) | Send message on facebook. (service=facebook)  \n\n## Messages: Forward\n\n### Action\n\nName| Description  \n---|---  \nmessages.forward| Requests to forward a message  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \nrecipient| _data_| list of objects| optional| Defines the name of the recipient. </br>Can be _all _if user requested all contacts.| Forward sms to all my contacts (recipient=all)  \nrecipient_name| _recipient_| string| required| Defines the name of the recipient| Forward this text to John. (recipient_name=John)  \nrecipient_number| _recipient_| string| optional| Defines the number of the recipient| Forward the message to +7(999)555-33-22 (recipient_number=+79995553322)  \nphone_type| _recipient_| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list)| Forward this text to John's work number. (phone_type=work)  \nsender| _data_| list of objects| optional| |  \nsender_name| _sender_| string| required| Defines the name of the sender.| Forward John's message. (sender_name=John)  \nsender_number| _sender_| string| optional| Defines the number of the sender.| Forward sms from +79629197810 (sender_number=+79629197810)  \nmessage| _data_| string| optional| Defines the text of the message.| Resend my sms where are you (message=where are you)  \n  \n## Messages: Reply\n\n### Action\n\nName| Description  \n---|---  \nmessages.reply| Requests to reply to a message  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \nsender| _data_| list of objects| optional| |  \nsender_name| _sender_| string| required| Defines the name of the sender.| Reply to John's message. (sender_name=John)  \nsender_number| _sender_| string| optional| Defines the number of the sender.| Reply to +79629197810 message. (sender_number=+79629197810)  \nphone_type| _sender_| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list)| Send a reply message to John's mobile. (phone_type=mobile)  \nmessage| _data_| string| optional| Defines the text of the message.| Reply to message from John thank you (message=thank you)  \nservice| _data_| string| optional| Defines the service to use. </br>_See the list of all available values_: </br>[Service List](#section-service-list)| Reply text message to google hangouts. (service=hangouts)  \n  \n## Messages: Read\n\n### Action\n\nName| Description  \n---|---  \nmessages.read| Requests to search / read messages  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \nfolder| _data_| string| optional| Defines the folder to search. </br>Predefined values: _inbox_| Read messages from travel folder. (folder=travel) <br> Read messages from inbox. (folder=inbox)  \nunread| _data_| string| optional| Defines request to find unread emails. </br>Available values: _true_| Read new message. (unread=true)  \nrecipient| _data_| list of objects| optional| | \nrecipient_name| _recipient_| string| required| Defines the name of the recipient.| Read texts to John (recipient_name=John)  \nrecipient_number| _recipient_| string| optional| Defines the number of the recipient.| Read text to +7(999)555-33-22 (recipient_number=+79995553322)  \nphone_type| _recipient_| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list)| Read texts to John's mobile. (phone_type=mobile)  \nsender| _data_| list of objects| optional| |  \nsender_name| _sender_| string| required| Defines the name of the sender.| Read texts from John. (sender_name=John)  \nsender_number| _sender_| string| optional| Defines the number of the sender.| Read texts from +7(999)555-33-22 (sender_number=+79995553322)  \nphone_type| _sender_| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list)| Read texts from John's mobile. (phone_type=mobile)  \nmessage| _data_| string| optional| Defines the text of the message.| Read messages with text Hello (message=Hello)  \nservice| _data_| string| optional| Defines the service to search messages for. _See the list of all available values_: </br>[Service List](#section-service-list)| Read my new viber messages. (service=viber)  \n  \n## Messages: Check\n\n### Action\n\nName| Description  \n---|---  \nmessages.check| Requests to check messages  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \nfolder| _data_| string| optional| Defines the folder to search.| Check messages from travel folder. (folder=travel)  \nunread| _data_| string| optional| Defines request to find unread emails. </br>Available values: _true_| Are there any new messages? (unread=true)  \nrecipient| _data_| list of objects| optional| | \nrecipient_name| _recipient_| string| required| Defines the name of the recipient.| Check my texts to John. (recipient_name=John)  \nrecipient_number| _recipient_| string| optional| Defines the number of the recipient.| Check text to +7(999)555-33-22 (recipient_number=+79995553322)  \nphone_type| _recipient_| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list)| Check texts to John's mobile. (phone_type=mobile)  \nsender| _data_| list of objects| optional| |  \nsender_name| _sender_| string| required| Defines the name of the sender.| Check texts from John. (sender_name=John)  \nsender_number| _sender_| string| optional| Defines the number of the sender.| Check texts from +7(999)555-33-22 (sender_number=+79995553322)  \nphone_type| _sender_| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list)| Check texts from John's mobile. (phone_type=mobile)  \nmessage| _data_| string| optional| Defines the text of the message.| Check messages with text Hello (message=Hello)  \nservice| _data_| string| optional| Defines the service to search messages for. </br>_See the liso of all available values_: </br>[Service List](#section-service-list)| Check my whatsapp messages. (service=whatsapp)  \n  \n## Messages: Notify: On\n\n### Action\n\nName| Description  \n---|---  \nmessages.notify_on| Requests to notify about new messages  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \nfolder| _data_| string| optional| Defines the folder to search.| Notify me about new message from folder travel. (folder=travel)  \nsender| _data_| list of objects| optional| |  \nsender_name| _sender_| string| required| Defines the name of the sender.| Notify about new text from john (sender_name=John)  \nsender_number| _sender_| string| optional| Defines the number of the sender.| Notify about new text from +7(999)555-33-22 (sender_number=+79995553322)  \nmessage| _data_| string| optional| Defines the text of the message.| Notify about new text containing hello how are you (message=hello how are you)  \nservice| _data_| string| optional| Defines the service to use. </br>_See the liso of all available values_: </br>[Service List](#section-service-list)| Notify me about new viber messages. (service=viber)  \nunread| _data_| string| optional| Defines request to find unread emails. </br>Available values: _true_| Notify me about new viber messages. (unread=true)  \n  \n## Messages: Notify: Off\n\n### Action\n\nName| Description  \n---|---  \nmessages.notify_off| Requests not to notify about new messages  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \nfolder| _data_| string| optional| Defines the folder to search.| Don't notify me about new message from folder travel. (folder=travel)  \nsender| _data_| list of objects| optional| |  \nsender_name| _sender_| string| required| Defines the name of the sender.| Don't notify about new text from john (sender_name=John)  \nsender_number| _sender_| string| optional| Defines the number of the sender.| Don't notify about new text from +7(999)555-33-22 (sender_number=+79995553322)  \nmessage| _data_| string| optional| Defines the text of the message.| Don't notify about new text containing hello how are you (message=hello how are you)  \nservice| _data_| string| optional| Defines the service to use. </br>_See the liso of all available values_: </br>[Service List](#section-service-list)| Don't notify me about new viber messages. (service=viber)  \nunread| _data_| string| optional| Defines request to find unread emails. Available values: _true_| Don't notify me about new viber messages. (unread=true) \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Contacts: Nicknames\"\n}\n[/block]\n## Action\n\nName| Description  \n---|---  \ncontacts.nicknames_save| Requests to save a nickname in a contact list  \ncontacts.nicknames_get| Requests to show a nickname from a contact list  \ncontacts.nicknames_remove| Requests to remove a nickname from a contact in a contact list  \ncontacts.nicknames_clear| Request to remove all nicknames  \ncontacts.nicknames_change| Request to change nickname  \n  \n## Data\n\nName| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---  \nname| string| optional| Defines the query| save a nickname for john (name=john)  \nnickname| string| optional| Defines the number| assign nickname bro (nickname=bro)\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Contacts: Manage\"\n}\n[/block]\n## Contacts: Search\n\n### Action\n\nName| Description  \n---|---  \ncontacts.search| Requests to search for a number  \n  \n### Data\n\nName| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---  \nq| string| optional| Defines the unknown query. Can be _my number_ if user asks to call his own number.| Find number for my boyfriend. (q=boyfriend) <br> What's my phone number. (q=my number)  \nphone_type| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list)| Find John's mobile number. (phone_type=mobile) <br> Do you know my home number? (phone_type=home)  \nname_first| string| optional| Defines the first name.| Find number for John. (name_first=John)  \nname_last| string| optional| Defines the last name.| Find number for John Smith. (name_last=Smith)  \n  \n## Contacts: Index: On\n\n### Action\n\nName| Description  \n---|---  \ncontacts.index_on| Requests to index contact list  \n  \n## Contacts: Index: Off\n\n### Action\n\nName| Description  \n---|---  \ncontacts.index_off| Requests not to index contact list \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Reference\"\n}\n[/block]\n## Call Type List\n\nmissed  \nincoming  \noutgoing\n\n## Email Type List\n\nhome  \nmain  \nother  \nwork\n\n## Phone Type List\n\nfax  \nhome  \niPhone  \nmain  \nmobile  \nother  \npager  \nskype  \nwork\n\n## Service List\n\nblackberry  \nfacebook  \nhangouts","excerpt":"","slug":"contacts","type":"basic","title":"Contacts"}
[block:callout] { "type": "info", "body": "This domain is supported in the following languages:\n* English\n* Italian\n* Japanese" } [/block] * [Contacts: Calls](#contacts-calls) * [Contacts: Emails](#contacts-emails) * [Contacts: Messages](#contacts-messages) * [Contacts: Nicknames](#contacts-nicknames) * [Contacts: Manage](#contacts-manage) [block:api-header] { "type": "basic", "title": "Contacts: Calls" } [/block] ## Call / Dial ### Action Name| Description ---|--- call.call| Requests to call a number, contact or venue call.dial| Requests to dial a number, contact or venue ### Data Name| Data type| Required / Optional| Description| Request examples ---|---|---|---|--- q| string| optional| Defines the unknown query. </br>Can be _my number_ if user asks to call his own number.| Call ewqewq. (q=ewqewq) <br> Dial my phone number. (q=my number) number| string| optional| Defines the number.| Call 5555. (number=5555) phone_type| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list) | Call John on mobile number. (phone_type=mobile) call_type| string| optional| Defines the call type. </br>_See the list of available values_: </br>[Call Type List](#section-call-type-list) | Call last number I called. (call_type=outgoing) <br> Dial my last missed call. (call_type=missed) name_first| string| optional| Defines the first name| Call John. (name_first=John) name_last| string| optional| Defines the last name| Call John Smith. (name_last=Smith) venue_title| string| optional| Defines the venue name| Call Empire State Building. (venue_title=Empire State Building) venue_chain| string| optional| Defines the venue chain| Call Starbucks. (venue_chain=Starbucks) venue_type| string| optional| Defines the venue type| Call restaurant. (venue_type=restaurant) ## Call Back / Redial ### Action Name| Description ---|--- call.call_back| Requests to call back call.redial| Requests to redial ### Data Name| Data type| Required / Optional| Description| Request examples ---|---|---|---|--- q| string| optional| Defines the unknown query. </br>Can be _my number_ if user asks to call his own number. | Call ewqewq back. (q=ewqewq) <br> Redial my home number. (q=my number) number| string| optional| Defines the number| Redial 5555. (number=5555) phone_type| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list)| Call John again on mobile number. (phone_type=mobile) call_type| string| optional| Defines the call type. </br>_See the list of available values_: </br>[Call Type List](#section-call-type-list)| Redial last number I called. (call_type=outgoing) <br> Call back my last missed call. (call_type=missed) name_first| string| optional| Defines the first name| Call John again. (name_first=John) name_last| string| optional| Defines the last name| Call back John Smith. (name_last=Smith) venue_title| string| optional| Defines the venue name| Call Empire State Building again. (venue_title=Empire State Building) venue_chain| string| optional| Defines the venue chain| Call Starbucks again. (venue_chain=Starbucks) venue_type| string| optional| Defines the venue type| Call restaurant again. (venue_type=restaurant) ## Call: Answer ### Action Name| Description ---|--- call.answer| Specifies how to answer incoming call ### Data Name| Data type| Required / Optional| Description| Request examples ---|---|---|---|--- speaker| string| optional| Defines whether to use speaker or no.</br>Available values: _on_, _off_ | Answer call with speaker off. (speaker=off) video| string| optional| Defines whether to use video or no.</br>Available values: _on_, _off_| Answer call with video. (video=on) ## Call: Get ### Action Name| Description ---|--- call.contact_get| Requests to know who is calling at the moment ## Call: End ### Action Name| Description ---|--- call.end| Requests to end the call ## Call: Search ### Action Name| Description ---|--- call.search| Requests to search for recent calls ### Data Name| Data type| Required / Optional| Description| Request examples ---|---|---|---|--- call_type| string| optional| Defines the call type. </br>_See the list of available values_: </br>[Call Type List](#section-call-type-list)| Last number I called. (call_type=outgoing) <br> Show my last missed call. (call_type=missed) ## Call: Confirm: On ### Action Name| Description ---|--- call.confirm_on| Requests to confirm before calling ## Call: Confirm: Off ### Action Name| Description ---|--- call.confirm_off| Requests not to confirm before calling ## Call: Voicemail ### Action Name| Description ---|--- call.voicemail| Requests to check voicemail [block:api-header] { "type": "basic", "title": "Contacts: Emails" } [/block] ## Email: Write ### Action Name| Description ---|--- email.write| Requests to compose an email ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- recipient| _data_| list of objects| optional| | recipient_name| _recipient_| string| required| Defines the name of the recipient.| Email John. (recipient_name=John) recipient_address| _recipient_| string| optional| Defines the address of the recipient.| Email john@speaktoit.com (recipient_address=john@speaktoit.com) email_type| _recipient_| string| optional| Defines the type of email. </br>_See the list of all available values_: </br>[Email Type List](#section-email-type-list) | Email John's work address. (email_type=work) message| _data_| string| optional| Defines the text of the email.| Email John how are you. (message=how are you) subject | _data_| string| optional| Defines the subject of the email| Email subject hello message how are you. (subject=hello) q| _data_| string| optional| Defines the part of the phrase which is hard to determine whether it's name of the recipeint or the text to send.| Email Hello how are you? (q=Hello) ## Email: Forward ### Action Name| Description ---|--- email.forward| Requests to forward an email ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- recipient| _data_| list of objects| optional| Defines the name of the recipient. </br>Can be _all _if user requested all contacts.| Forward email to all my contacts. (recipient=all) recipient_name| _recipient_| string| required| Defines the name of the recipient.| Forward email to John. (recipient_name=John) recipient_address| _recipient_| string| optional| Defines the address of the recipient.| Forward email to john@speaktoit.com (recipient_address=john@speaktoit.com) sender| _data_| list of objects| optional| | sender_name| _sender_| string| required| Defines the name of the sender.| Forward email from John. (sender_name=John) sender_address| _sender_| string| optional| Defines the address of the sender.| Forward email from john@speaktoit.com (sender_address=john@speaktoit.com) message| _data_| string| optional| Defines the text of the email.| Resend email how are you to John. (message=how are you) subject| _data_| string| optional| Defines the subject of the email.| Resend email with subject hello (subject=hello) ## Email: Reply ### Action Name| Description ---|--- email.reply| Requests to reply to an email ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- sender| _data_| list of objects| optional| | sender_name| _sender_| string| required| Defines the name of the sender.| Reply to mail from John. (sender_name=John) sender_address| _sender_| string| optional| Defines the address of the sender.| Reply to john@speaktoit.com email. (sender_address=john@speaktoit.com) email_type| _recipient_| string| optional| Defines the type of email. </br>_See the list of all available values_: </br>[Email Type List](#section-email-type-list)| Reply to John's work address. (email_type=work) message| _data_| string| optional| Defines the text of the email.| Reply to email from John thank you. (message=thank you.) subject| _data_| string| optional| Defines the subject of the email.| Reply to email with subject hello (subject=hello) ## Email: Read ### Action Name| Description ---|--- email.read| Requests to read emails ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- folder| _data_| string| optional| Defines the folder to search.| Read emails from folder travel (folder=travel) unread| _data_| string| optional| Defines request to find unread emails. </br>Available values: _true _| Read new email. (unread=true) recipient| _data_| list of objects| optional| | recipient_name| _recipient_| string| required| Defines the name of the recipient.| Read mails to John. (recipient_name=John) recipient_address| _recipient_| string| optional| Defines the address of the recipient.| Read my mails to john@speaktoit.com (recipient_address=john@speaktoit.com) sender| _data_| list of objects| optional| | sender_name| _sender_| string| required| Defines the name of the sender.| Read email from John. (sender_name=john) sender_address| _sender_| string| optional| Defines the address of the sender.| Read email from john@speaktoit.com (sender_address=john@speaktoit.com) message| _data_| string| optional| Defines the text of the email.| Read emails with text how are you (message=how are you) subject| _data_| string| optional| Defines the subject of the email.| Read emails with subject hello (subject=hello) ## Email: Check ### Action Name| Description ---|--- email.check| Requests to check emails ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- folder| _data_| string| optional| Defines the folder to search.| Check email from folder travel (folder=travel) unread| _data_| string| optional| Defines request to check for unread emails. </br>Available values: _true _| Any new emails? (unread=true) recipient| _data_| list of objects| optional| | recipient_name| _recipient_| string| required| Defines the name of the recipient.| Check my mails to John. (recipient_name=John) recipient_number| _recipient_| string| optional| Defines the number of the recipient.| Check mails to john@speaktoit.com (sender_address=john@speaktoit.com) sender| _data_| list of objects| optional| | sender_name| _sender_| string| required| Defines the name of the sender.| Do I have mails from John? (sender_name=John) sender_address| _sender_| string| optional| Defines the address of the sender.| Any new mails from john@speaktoit.com (sender_address=john@speaktoit.com) message| _data_| string| optional| Defines the text of the email.| Do I have any mails with text hello (message=hello) subject| _data_| string| optional| Defines the subject of the email.| Do I have any mails with subject hello (subject=hello) ## Email: Notify: On ### Action Name| Description ---|--- email.notify_on| Requests to notify about new emails ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- folder| _data_| string| optional| Defines the folder to search| Notify about new emails from folder travel (folder=travel) sender| _data_| list of objects| optional| | sender_name| _sender_| string| required| Defines the name of the sender| Notify about new emails from John. (sender_name=John) sender_address| _sender_| string| optional| Defines the address of the sender| Notify about new emails from john@speaktoit.com (sender_address=john@speaktoit.com) message| _data_| string| optional| Defines the message of the email| Notify about new emails containing hello how are you (message=hello how are you) unread| _data_| string| optional| Defines request to find unread emails. </br>Available values: _true _| Notify about new emails. (unread=true) ## Email: Notify: Off ### Action Name| Description ---|--- email.notify_off| Requests not to notify about new emails ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- folder| _data_| string| optional| Defines the folder to search| Don't notify about new emails from folder travel (folder=travel) sender| _data_| list of objects| optional| | sender_name| _sender_| string| required| Defines the name of the sender| Don't notify about new emails from John. (sender_name=John) sender_address| _sender_| string| optional| Defines the address of the sender| Don't notify about new emails from john@speaktoit.com (sender_address=john@speaktoit.com) message| _data_| string| optional| Defines the message of the email| Don't notify about new emails containing hello how are you (message=hello how are you) unread| _data_| string| optional| Defines request to find unread emails. </br>Available values: _true _| Don't notify about new emails. (unread=true) [block:api-header] { "type": "basic", "title": "Contacts: Messages" } [/block] ## Messages: Write ### Action Name| Description ---|--- messages.write| Requests to compose a message ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- recipient| _data_| list of objects| optional| | recipient_name| _recipient_| string| required| Defines the name of the recipient.| Message John. (recipient_name=John) recipient_number| _recipient_| string| optional| Defines the number of the recipient.| Message +7(999)555-33-22 (recipient_number=+79995553322) phone_type| _recipient_| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list)| Message John on mobile. (phone_type=mobile) message| _data_| string| optional| Defines the text of the message.| Message John How are you? (message=How are you?) q| _data_| string| optional| Defines the part of the phrase which is hard to determine whether it's name of the recipeint or the text to send.| Message Hello how are you? (q=Hello) service| _data_| string| optional| Defines the service to use. </br>_See the list of all available values_: </br>[Service List](#section-service-list) | Send message on facebook. (service=facebook) ## Messages: Forward ### Action Name| Description ---|--- messages.forward| Requests to forward a message ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- recipient| _data_| list of objects| optional| Defines the name of the recipient. </br>Can be _all _if user requested all contacts.| Forward sms to all my contacts (recipient=all) recipient_name| _recipient_| string| required| Defines the name of the recipient| Forward this text to John. (recipient_name=John) recipient_number| _recipient_| string| optional| Defines the number of the recipient| Forward the message to +7(999)555-33-22 (recipient_number=+79995553322) phone_type| _recipient_| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list)| Forward this text to John's work number. (phone_type=work) sender| _data_| list of objects| optional| | sender_name| _sender_| string| required| Defines the name of the sender.| Forward John's message. (sender_name=John) sender_number| _sender_| string| optional| Defines the number of the sender.| Forward sms from +79629197810 (sender_number=+79629197810) message| _data_| string| optional| Defines the text of the message.| Resend my sms where are you (message=where are you) ## Messages: Reply ### Action Name| Description ---|--- messages.reply| Requests to reply to a message ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- sender| _data_| list of objects| optional| | sender_name| _sender_| string| required| Defines the name of the sender.| Reply to John's message. (sender_name=John) sender_number| _sender_| string| optional| Defines the number of the sender.| Reply to +79629197810 message. (sender_number=+79629197810) phone_type| _sender_| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list)| Send a reply message to John's mobile. (phone_type=mobile) message| _data_| string| optional| Defines the text of the message.| Reply to message from John thank you (message=thank you) service| _data_| string| optional| Defines the service to use. </br>_See the list of all available values_: </br>[Service List](#section-service-list)| Reply text message to google hangouts. (service=hangouts) ## Messages: Read ### Action Name| Description ---|--- messages.read| Requests to search / read messages ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- folder| _data_| string| optional| Defines the folder to search. </br>Predefined values: _inbox_| Read messages from travel folder. (folder=travel) <br> Read messages from inbox. (folder=inbox) unread| _data_| string| optional| Defines request to find unread emails. </br>Available values: _true_| Read new message. (unread=true) recipient| _data_| list of objects| optional| | recipient_name| _recipient_| string| required| Defines the name of the recipient.| Read texts to John (recipient_name=John) recipient_number| _recipient_| string| optional| Defines the number of the recipient.| Read text to +7(999)555-33-22 (recipient_number=+79995553322) phone_type| _recipient_| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list)| Read texts to John's mobile. (phone_type=mobile) sender| _data_| list of objects| optional| | sender_name| _sender_| string| required| Defines the name of the sender.| Read texts from John. (sender_name=John) sender_number| _sender_| string| optional| Defines the number of the sender.| Read texts from +7(999)555-33-22 (sender_number=+79995553322) phone_type| _sender_| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list)| Read texts from John's mobile. (phone_type=mobile) message| _data_| string| optional| Defines the text of the message.| Read messages with text Hello (message=Hello) service| _data_| string| optional| Defines the service to search messages for. _See the list of all available values_: </br>[Service List](#section-service-list)| Read my new viber messages. (service=viber) ## Messages: Check ### Action Name| Description ---|--- messages.check| Requests to check messages ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- folder| _data_| string| optional| Defines the folder to search.| Check messages from travel folder. (folder=travel) unread| _data_| string| optional| Defines request to find unread emails. </br>Available values: _true_| Are there any new messages? (unread=true) recipient| _data_| list of objects| optional| | recipient_name| _recipient_| string| required| Defines the name of the recipient.| Check my texts to John. (recipient_name=John) recipient_number| _recipient_| string| optional| Defines the number of the recipient.| Check text to +7(999)555-33-22 (recipient_number=+79995553322) phone_type| _recipient_| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list)| Check texts to John's mobile. (phone_type=mobile) sender| _data_| list of objects| optional| | sender_name| _sender_| string| required| Defines the name of the sender.| Check texts from John. (sender_name=John) sender_number| _sender_| string| optional| Defines the number of the sender.| Check texts from +7(999)555-33-22 (sender_number=+79995553322) phone_type| _sender_| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list)| Check texts from John's mobile. (phone_type=mobile) message| _data_| string| optional| Defines the text of the message.| Check messages with text Hello (message=Hello) service| _data_| string| optional| Defines the service to search messages for. </br>_See the liso of all available values_: </br>[Service List](#section-service-list)| Check my whatsapp messages. (service=whatsapp) ## Messages: Notify: On ### Action Name| Description ---|--- messages.notify_on| Requests to notify about new messages ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- folder| _data_| string| optional| Defines the folder to search.| Notify me about new message from folder travel. (folder=travel) sender| _data_| list of objects| optional| | sender_name| _sender_| string| required| Defines the name of the sender.| Notify about new text from john (sender_name=John) sender_number| _sender_| string| optional| Defines the number of the sender.| Notify about new text from +7(999)555-33-22 (sender_number=+79995553322) message| _data_| string| optional| Defines the text of the message.| Notify about new text containing hello how are you (message=hello how are you) service| _data_| string| optional| Defines the service to use. </br>_See the liso of all available values_: </br>[Service List](#section-service-list)| Notify me about new viber messages. (service=viber) unread| _data_| string| optional| Defines request to find unread emails. </br>Available values: _true_| Notify me about new viber messages. (unread=true) ## Messages: Notify: Off ### Action Name| Description ---|--- messages.notify_off| Requests not to notify about new messages ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- folder| _data_| string| optional| Defines the folder to search.| Don't notify me about new message from folder travel. (folder=travel) sender| _data_| list of objects| optional| | sender_name| _sender_| string| required| Defines the name of the sender.| Don't notify about new text from john (sender_name=John) sender_number| _sender_| string| optional| Defines the number of the sender.| Don't notify about new text from +7(999)555-33-22 (sender_number=+79995553322) message| _data_| string| optional| Defines the text of the message.| Don't notify about new text containing hello how are you (message=hello how are you) service| _data_| string| optional| Defines the service to use. </br>_See the liso of all available values_: </br>[Service List](#section-service-list)| Don't notify me about new viber messages. (service=viber) unread| _data_| string| optional| Defines request to find unread emails. Available values: _true_| Don't notify me about new viber messages. (unread=true) [block:api-header] { "type": "basic", "title": "Contacts: Nicknames" } [/block] ## Action Name| Description ---|--- contacts.nicknames_save| Requests to save a nickname in a contact list contacts.nicknames_get| Requests to show a nickname from a contact list contacts.nicknames_remove| Requests to remove a nickname from a contact in a contact list contacts.nicknames_clear| Request to remove all nicknames contacts.nicknames_change| Request to change nickname ## Data Name| Data type| Required / Optional| Description| Request examples ---|---|---|---|--- name| string| optional| Defines the query| save a nickname for john (name=john) nickname| string| optional| Defines the number| assign nickname bro (nickname=bro) [block:api-header] { "type": "basic", "title": "Contacts: Manage" } [/block] ## Contacts: Search ### Action Name| Description ---|--- contacts.search| Requests to search for a number ### Data Name| Data type| Required / Optional| Description| Request examples ---|---|---|---|--- q| string| optional| Defines the unknown query. Can be _my number_ if user asks to call his own number.| Find number for my boyfriend. (q=boyfriend) <br> What's my phone number. (q=my number) phone_type| string| optional| Defines the phone type. </br>_See the list of available values_: </br>[Phone Type List](#section-phone-type-list)| Find John's mobile number. (phone_type=mobile) <br> Do you know my home number? (phone_type=home) name_first| string| optional| Defines the first name.| Find number for John. (name_first=John) name_last| string| optional| Defines the last name.| Find number for John Smith. (name_last=Smith) ## Contacts: Index: On ### Action Name| Description ---|--- contacts.index_on| Requests to index contact list ## Contacts: Index: Off ### Action Name| Description ---|--- contacts.index_off| Requests not to index contact list [block:api-header] { "type": "basic", "title": "Reference" } [/block] ## Call Type List missed incoming outgoing ## Email Type List home main other work ## Phone Type List fax home iPhone main mobile other pager skype work ## Service List blackberry facebook hangouts