# Configureer SosoAPI voor de persoon die deze assistent gebruikt Gebruik de bestaande assistent van de persoon en behoud de oorspronkelijke taak, inhoud en mediaverwijzingen in dit gesprek. Gebruik één SosoAPI MCP voor de verbonden socialmedia-accounts. Hergebruik een bestaande verbinding of kies lokale of gehoste toegang hieronder. Configuratie publiceert geen bericht. De persoon meldt zich aan en kiest wat die wil autoriseren in de browser. Voer nooit hun inloggegevens in en geef geen toestemming voor hen. Voor Free is geen betaalkaart nodig. ## 1. Verbind deze assistent Controleer eerst de huidige host en de bestaande SosoAPI-configuratie. Hergebruik een werkende verbinding; meld je niet af, overschrijf geen configuratie en maak geen extra verbinding alleen omdat deze handleiding opnieuw is geopend. Controleer voor een lokale shell of Node.js 20 of later en npx beschikbaar zijn. Gebruik een bestaande ondersteunde runtime. Als die ontbreekt, leg de vereiste uit in gewone taal; voer niet automatisch bevoorrechte of globale systeemwijzigingen uit. Claude Code: ```sh claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi ``` Codex: ```sh codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi ``` Controleer na het registreren van de server of je de tools ervan kunt aanroepen in deze gesprek. Als de host opnieuw moet verbinden of starten, vertel de persoon welke benodigde actie. Wacht totdat de tools werken voordat je zegt dat de verbinding gereed is. Nieuwe verbindingen gebruiken het bestaande core-profiel met 28 tools voor normale publicatie, media, reacties en statistieken. Een werkende full-profielverbinding moet worden hergebruikt. Als een gevraagde beheerbewerking ontbreekt, leg uit dat het full-profiel beschikbaar is; een tool verbergen verleent of ontneemt geen machtiging. Voeg voor een browserclient zoals ChatGPT met ondersteuning voor aangepaste MCP-apps deze externe MCP-URL toe en kies OAuth met automatische clientregistratie: `https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp` Er hoeft geen API-sleutel, client-ID of clientgeheim te worden geplakt. De persoon meldt zich aan bij SosoAPI en kiest werkruimten/acties. Aangepaste ChatGPT-apps hangen af van van het abonnement en beschikbaarheid van de ontwikkelaarsmodus. Hergebruik een werkende lokale of externe verbinding als die al is geconfigureerd. X ondersteunt oorspronkelijke tekst en links. Elke organisatie deelt 10 Free X-credits eenmalig, of 100 per Pro-factureringsperiode. Gewone tekst kost 1; een bericht met een URL kost 10. Lees `sosoapi_get_x_usage` met workspace_id voordat je X-gebruik plant. Er worden geen automatische overschrijdingskosten berekend; een onzekere publicatie houdt haar credit reservering en moet worden afgestemd voordat opnieuw wordt verzonden. ## 2. Meld je aan zonder API-sleutel De eerste geauthenticeerde MCP-aanroep opent de bestaande browseraanmelding en agent- toestemmingsprocedure. De persoon kan Google gebruiken of zich registreren en het e-mailadres verifiëren. Laat de persoon een werkruimte kiezen en bepalen of de assistent alleen inhoud mag voorbereiden of ook mag inplannen en publiceren. Vraag niet om inloggegevens te kopiëren. Publicatietoestemming loopt door binnen het gekozen bereik en is geen verplicht goedkeuringsscherm voor elk bericht. Laat sleutelbeheer uit voor gewone publicatie. Registratie en aanmelding met e-mail gebruiken beveiligingsverificatie op de achtergrond, zonder een selectievakje dat de persoon zelf moet afhandelen. Als verificatie mislukt, meld dan de werkelijke fout en gebruik de beschikbare actie om opnieuw te proberen; vraag de persoon niet om te zoeken of te klikken op CAPTCHA-vakje. De bestaande optie **Doorgaan met Google** is ook beschikbaar als de persoon Google wil gebruiken; Google kan een eigen identiteitscontrole vereisen. Laat de persoon het account kiezen en toegang goedkeuren. Behoud de huidige aanmeld-/goedkeuringslink en terugkeerbestemming; vervang deze door een kale registratielink en schakel niet stilzwijgend naar een bestaande beheerdersidentiteit. Eén aanmeldfout bewijst niet dat elke aanmeldmethode onbeschikbaar is. Pauzeer alleen de stap die de identiteit of toestemming van de persoon vereist. Terwijl die deze afrondt, voltooi de installatiecontroles en bereid het oorspronkelijke concept voor zonder een account of werkruimte te verzinnen. Leg uit wat al gereed is en welke ene vervolgactie nodig is. Lees na aanmelding de geauthenticeerde context opnieuw en hervat de dezelfde taak. Schakel CAPTCHA niet uit, gebruik geen beheerdersregistratie-API's, vraag niet om tokens, of beweren dat account/verbinding gereed is voordat het werkelijke proces voltooid is. Als de MCP-tools een herstart van de host vereisen, is de lokale CLI ook beschikbaar voor deze assistent. Voer uit `npx -y sosoapi auth status` eerst; gebruik `npx -y sosoapi auth login` alleen wanneer aanmelden nodig is. Lees nooit de bestand met inloggegevens en toon geen tokens. Als aanmelden het verkeerde browserprofiel opent, stop die openstaande aanmelding voordat je een nieuwe `npx -y sosoapi auth login --no-open`. De persoon opent de nieuwe getoonde link in het bedoelde profiel en controleert de de aangemelde identiteit voordat je toestemming geeft. Gebruik nooit twee profielen tegelijk voor dezelfde link. Gebruik `--help` eerst om te bevestigen dat deze hersteloptie in de geïnstalleerde CLI bestaat; als die ontbreekt, leg de versiebeperking uit en verzin geen werkende optie. De CLI kan de ingebouwde contracten bekijken: ```sh npx -y sosoapi api contract --summary npx -y sosoapi api contract --route /studio-api/scheduled-posts/ ``` De CLI-verzoeksyntaxis is `sosoapi api post < request.json`. Schrijf de JSON met je bestandstool; voeg gebruikersinhoud niet via interpolatie toe aan shell- opdrachten. Lees http_status en de antwoordinhoud, niet alleen de procesafsluitcode code. Een API-fout is geen succes. Gebruik alleen routes en schema's uit het ingebouwd contract; verzin geen namen en omzeil geen ontbrekende mogelijkheid. ## 3. Verbind het eigen socialmedia-account van de persoon Bepaal de geauthenticeerde organisatie en werkruimte vanuit de SosoAPI-context. Raad nooit identifiers en vervang nooit stilzwijgend een werkruimte. Als meer dan één geschikt merk heeft, vraag dan welk merk de persoon bedoelt. Gebruik een bestaande verbinding als die gezond is. Voer anders uit `npx -y sosoapi connect ` (instagram, threads, facebook, youtube of x) of geef de persoon https://app.sosoapi.ai/connect. De persoon voltooit de provider- toestemming en bekijk het exacte account in de browser. Nadat de persoon terug is, lees de accounts en publicatiemogelijkheden opnieuw. Een verbindingscallback is geen bewijs dat publiceren is toegestaan. Hergebruik het oorspronkelijke concept; vraag de persoon een interne identifier te laten kopiëren of de inhoud opnieuw te laten maken. ## 4. Rond de oorspronkelijke publicatietaak af Gebruik het bestaande verzoek van de persoon of vraag wat die wil promoten. Verzin geen testbericht. Toon het exacte doelaccount, de inhoud, media en lokale datum/tijd vóór de eerste indiening. Bevestig de tijdzone wanneer die onbekend. Lees de actuele accountmogelijkheden; een persoonlijk Instagram-account of ontbrekende providerrechten kunnen een ondersteund accounttype of nieuwe verbinding vereisen. X accepteert alleen oorspronkelijke tekst en links; laat media leeg. X-media, antwoorden, citaten, reposts en het publiceren van threads worden niet ondersteund. Registreer media vóór het inplannen voor bestemmingen die media ondersteunen: gebruik voor een lokaal bestand sosoapi_upload_asset binnen de toegestane mappen; gebruik voor een externe URL sosoapi_import_asset_url en controleer sosoapi_get_asset_import_status met include_asset=true totdat de begrensde import gereed is. De gereedstaande asset.id wordt media.asset_id en asset.asset_url wordt media.url; een aparte get_asset-aanroep is niet nodig. Behoud dezelfde importidentiteit, volg instructies voor opnieuw proberen en stop bij een definitieve mislukking. Een geslaagd verzoek bewijst niet dat decoderen/importeren voltooid is. Lees bij stilstand sosoapi_job_status met de job_id van die import voordat je opnieuw wacht. Een wachtende taak kan al een uitvoeringsfout bevatten. Een service- configuratiefout vraagt om aandacht van een beheerder, niet om nog een import, een nieuw socialmedia- verbinding of toestemming van de persoon. Meld de blokkade zonder te beweren dat de afbeelding gereed is. Gebruik de teruggegeven geregistreerde media-ID en canonieke media-URL samen. Gebruik nooit de oorspronkelijke externe URL of een tijdelijke voorbeeld-URL als vervanging inplannen. Hergebruik een bestaand gereed mediabestand pas na controle van werkruimte en identiteit. Gebruik sosoapi_get_scheduled_post_eligibility wanneer een adviserend voorbeeld nuttig is; dit is optioneel en vervangt de canonieke validatie bij aanmaak/uitvoering niet. Gebruik de canonieke Scheduled Post tools. Eén bericht heeft één bestemming. Hergebruik dezelfde idempotency_key bij opnieuw proberen van exact hetzelfde verzoek; een gewijzigd concept is een nieuw verzoek. Lees na een time-out, lees het bestaande bericht voordat je iets anders doet. Verstuur nooit blind opnieuw een onzekere schrijfhandeling bij de provider. Bijwerken, annuleren en expliciet opnieuw proberen gebruiken de huidige versie en de actietoelaatbaarheid van de server. Het resultaat moet onderscheid maken tussen: - Ingepland: geaccepteerd voor het opgegeven tijdstip; nog niet gepubliceerd. - Bezig of in afstemming: het definitieve resultaat is onbevestigd; verstuur niet opnieuw. - Gepubliceerd: een definitief resultaat met providerbewijs bevestigt het exacte bericht; geef de gepubliceerde link terug zodra beschikbaar. - Mislukt of aandacht nodig: vertel wat bekend is en wat de volgende toegestane actie is; verbind alleen het betreffende account opnieuw wanneer de persoon opnieuw toegang moet verlenen. Rapporteer bij meerdere bestemmingen elke bestemming apart. Noem de hele taak niet geslaagd wanneer slechts enkele platforms zijn geslaagd. Geef voor een toekomstige planning de bericht-IDs en geaccepteerde tijdstippen; laat het gesprek niet wachten tot het geplande tijdstip en maak geen pollinglus. Lees bij terugkeer dezelfde berichten opnieuw. De persoon kan het exacte resultaat ook opnieuw bekijken op https://app.sosoapi.ai/scheduled-posts/, met de echte teruggegeven ID van SosoAPI. Die pagina vereist hun eigen geautoriseerde aanmelding. Gebruik voor een aangepaste omgeving, gebruik in plaats daarvan de expliciet geconfigureerde app-origin. Beloof niet een gesloten assistent te activeren of een succesmelding te verzenden die niet is geconfigureerd en geverifieerd. ## Verwijzingen - Snelstart voor mensen: https://app.sosoapi.ai/start - Producthandleiding: https://sosoapi.ai/nl/docs/quickstart - Ondersteund bereik: Instagram, Threads, Facebook-pagina's, YouTube en oorspronkelijke X- tekst/links. Formaten en machtigingen verschillen per account; andere platforms zijn niet beschikbaar alleen omdat de persoon erom vraagt.