Discontinue the "not_contacted" unavailable chat reason

I discovered it's not possible to detect it anymore, so it's better to
remove it from the documentation.

Fixes: GH-73

Author: Pietro Albini

botogram/api.py

@@ -109,7 +109,7 @@ def call(self, method, params=None, files=None, expect=None):
                 elif status == 400 and "PEER_ID_INVALID" in message:
                     # Error code # 400
                     # PEER_ID_INVALID
-                    reason = "not_contacted"
+                    reason = "not_found"
 
                 # This happens when the bot can't contact the user or the user
                 # doesn't exist

docs/changelog/0.3.rst

@@ -18,9 +18,12 @@ botogram 0.3.3
   (`issue 71`_)
 * Fix broken detection of unavailable chats, due to changes in the Bot API
   (`issue 72`_)
+* Discontinue the unavailable chat reason **not_contacted** since it's not
+  possible to detect it anymore (`issue 73`_)
 
 .. _issue 71: https://github.com/pietroalbini/botogram/issues/71
 .. _issue 72: https://github.com/pietroalbini/botogram/issues/72
+.. _issue 73: https://github.com/pietroalbini/botogram/issues/73
 
 .. _changelog-0.3.2:
 

docs/unavailable-chats.rst

@@ -30,9 +30,6 @@ Here there is a list of the current reasons why a chat isn't available:
 * **account_deleted**: the user deleted his account, so you won't be able to
   send messages to him anymore.
 
-* **not_contacted**: the user hasn't contacted your bot directly yet. If the
-  user is in a group chat try to tell him to start your bot!
-
 * **chat_moved**: the chat was moved to a new ID. This currently happens if the
   group was converted into a supergroup.
 

tests/test_api.py

@@ -119,12 +119,13 @@ def test_unavailable_chats(api, mock_req):
     assert e.value.chat_id == 123
     assert e.value.reason == "kicked"
 
-    # Test a failed request with matching error code and description to an user
-    # which hasn't contacted your bot yet
+    # Test a failed request with matching error code and description, and in
+    # which Telegram failed to determine the reason why the user can't be
+    # contacted
     with pytest.raises(botogram.api.ChatUnavailableError) as e:
         api.call("sendLocation", {"chat_id": 123})
     assert e.value.chat_id == 123
-    assert e.value.reason == "not_contacted"
+    assert e.value.reason == "not_found"
 
     # Test a failed request with matching error code and description to an user
     # which deleted its account