Merge pull request #83 from codeforboston/fix/instagram-poster

fix: Added Error Handling and Polling to Instagram Poster

Author: danielbusnz

social_posters/instagram.py

@@ -1,4 +1,5 @@
 import os
+import time
 
 import requests
 
@@ -22,6 +23,7 @@ def platform_name(self) -> str:
 
     def authenticate(self) -> bool:
         if not self._is_available:
+            print("Instagram: credentials not set (INSTAGRAM_BUSINESS_ACCOUNT_ID or INSTAGRAM_PAGE_ACCESS_TOKEN missing)")
             return False
         try:
             response = requests.get(
@@ -32,7 +34,13 @@ def authenticate(self) -> bool:
             response.raise_for_status()
             self._authenticated = True
             return True
-        except Exception:
+        except requests.exceptions.HTTPError as exc:
+            body = exc.response.text if exc.response is not None else "no response body"
+            print(f"Instagram auth failed (HTTP {exc.response.status_code}): {body}")
+            self._authenticated = False
+            return False
+        except Exception as exc:
+            print(f"Instagram auth failed: {exc}")
             self._authenticated = False
             return False
 
@@ -51,14 +59,25 @@ def publish(self, post: Post) -> PostResult:
 
         try:
             container_id = self._create_media_container(post)
+            # Instagram needs time to process the uploaded image before publishing.
+            # Publishing immediately returns "Media ID is not available" (error 9007).
+            time.sleep(10)
+    
             media_id = self._publish_media(container_id)
             return PostResult(
                 success=True,
                 post_id=media_id,
                 post_url="https://www.instagram.com/cute.pets.boston/",
             )
+        except requests.exceptions.HTTPError as exc:
+            body = exc.response.text if exc.response is not None else "no response body"
+            error = f"Instagram publish failed (HTTP {exc.response.status_code}): {body}"
+            print(error)
+            return PostResult(success=False, error_message=error)
         except Exception as exc:
-            return PostResult(success=False, error_message=str(exc))
+            error = f"Instagram publish failed: {exc}"
+            print(error)
+            return PostResult(success=False, error_message=error)
 
     def _create_media_container(self, post: Post) -> str:
         """Create a media container and return its ID."""
@@ -75,6 +94,7 @@ def _create_media_container(self, post: Post) -> str:
         response.raise_for_status()
         return response.json()["id"]
 
+  
     def _publish_media(self, container_id: str) -> str:
         response = requests.post(
             f"{GRAPH_API_BASE}/{self.account_id}/media_publish",