Koble til din AI-assistent
Koble Claude, ChatGPT eller en annen MCP-klient til kundeportalen din. Assistenten kan lese prosjektene, fakturaene, supportsakene, nettstedstatus og filene dine. På Pro- og Ultra-planene kan den også åpne saker eller sende endringsforespørsler, men bare etter at du har bekreftet den nøyaktige forhåndsvisningen.
Verktøy og grenser
Hver plan setter sine egne grenser. Serveren håndhever antall nøkler, forespørsler per minutt per nøkkel og månedlige enheter for hele kontoen.
Basic
GratisKun lesing. Ingen skriving på denne planen
Se prosjekter, fakturaer, kundestøttesaker, sitestatus, prosjektfiler og månedsrapporten.
Pro
3,000,000 Toman / mnd.Lesing og bekreftede skrivinger
Alle lesverktøyene, pluss bekreftede skrivinger: åpne og svare på supportsaker, sende endringsforespørsler og Farr-meldinger, laste opp filer, opprette og oppdatere innholdsutkast, og godta eller avslå forslag. Hver skriving forhåndsvises først og brukes først når du har godkjent den.
Ultra
5,000,000 Toman / mnd.Alt i Pro, pluss masseoperasjoner og webhooks
Alt i Pro, pluss masseoperasjoner på saker (bulk_ticket_reply, bulk_ticket_close og bulk_actions, opptil 20 saker per kall), webhooks (webhook_list, webhook_create og webhook_delete) og planlagte månedsrapporter (scheduled_reports og scheduled_reports_get).
Sikkerhet: Ingen betalings- eller eierskapshandlinger
Assistent-API-et har ingen verktøy for å betale fakturaer, overføre penger, endre kontoeierskap eller administrere nøkler. Fakturaer er skrivebeskyttet. Betaling utføres av deg i kundeportalen.
Hvordan opprette en assistentnøkkel
Opprett en nøkkel i kundeportalen i tre trinn.
1. Logg inn på portalen
Logg inn på kundeportalen og åpne Assistenttilgang i menyen.
2. Opprett en nøkkel
Klikk på "Opprett nøkkel". Skriv inn et navn på 3 til 60 tegn (f.eks. "Claude Code - bærbar"), velg tillatelser og varighet. Opprettelse krever ny innlogging.
3. Kopier nøkkelen med en gang
Den fullstendige nøkkelen vises kun én gang rett etter opprettelsen. Serveren lagrer bare en SHA-256-hash av hemmeligheten. Hvis du mister den, må du tilbakekalle den og opprette en ny.
Hvordan koble til Claude & ChatGPT
Koble til via MCP Streamable HTTP-protokollen med en Bearer-nøkkel eller ved å logge inn med OAuth.
Claude Code og andre MCP-klienter
I verktøy som godtar en server-URL og headers, for eksempel .mcp.json-filen i Claude Code, legger du til denne oppføringen og erstatter plassholderen med nøkkelen din:
{
"mcpServers": {
"sajjad-portal": {
"type": "http",
"url": "https://sajjad.blog/api/client/mcp",
"headers": {
"Authorization": "Bearer <YOUR_AGENT_KEY>"
}
}
}
}ChatGPT og webassistenter
Legg til denne adressen som en tilpasset kobling og logg inn ved forespørsel (OAuth). Nøkkel er ikke nødvendig her. Menynavn kan variere.
Hva "Forhåndsvisning og bekreftelse" betyr for skrivehandlinger
En endring utføres aldri ved første kall.
Når en assistent kaller et skriveverktøy, lagrer serveren forespørselen og returnerer en forhåndsvisning med et engangstoken som utløper etter 10 minutter. Endringen utføres først når assistenten kaller bekreftelsesverktøyet med dette tokenet etter ditt samtykke. Hvert token fungerer kun én gang for den gitte kontoen og nøkkelen. Alle klargjorte handlinger loggføres.
Verifisert verktøyreferanse
De viktigste verktøyene klient-endepunktet tilbyr, pluss bekreftelsesverktøyet som brukes etter en forhåndsvisning. Et verktøy utenfor planen din avvises med en plan_required-melding.
| Verktøynavn | Tilgangstype | Funksjonsbeskrivelse |
|---|---|---|
| projects_list | Lese | List opptil 50 av prosjektene dine: kode, navn, status, fremdrift og sluttdato. |
| invoices_list | Lese | List opptil 25 fakturaer med forfallsdato, totalbeløp, innbetalt beløp, saldo og status. Bruk openOnly for kun å se ubetalte. Utkast og betalingslenker utelates. |
| tickets_list | Lese | List opptil 50 kundestøttesaker med status, prioritet og tidspunkt for siste svar. |
| ticket_get | Lese | Hent meldingshistorikken for en kundestøttesak (opptil 100 meldinger). Interne notater er utelatt. |
| ticket_create | Bekreftet skriving | Klargjør en ny kundestøttesak med lav eller normal prioritet. Opprettes kun etter godkjenning av forhåndsvisning. |
| ticket_reply | Bekreftet skriving | Klargjør et svar på en åpen sak. Lukkede saker kan ikke besvares. Sendes kun etter bekreftelse. |
| change_request_create | Bekreftet skriving | Klargjør en endringsforespørsel for et prosjekt. Trer i kraft kun etter godkjenning av forhåndsvisning. |
| site_status | Lese | Viser domenestatus, besøkende og sidevisninger (24 timer og 7 dager), oppetidsprosent og uløste feil for det tilkoblede nettstedet basert på siste telemetrisynkronisering. |
| files_list | Lese | List filer i prosjektlagringen, opptil 100 per side, eventuelt i en mappe. |
| file_link | Lese | Opprett en nedlastingslenke for en lagret fil. Lenken utløper etter 15 minutter. |
| report_monthly | Lese | Få et månedlig sammendrag (opptil 12 måneder tilbake): prosjekter, åpne/lukkede saker, nettstedsbilde, forfalte fakturaer og PDF-lenke gyldig i 15 minutter. |
Ofte stilte spørsmål
Vanlige spørsmål om kundeassistenter, sikkerhet og bruksgrenser.
Kan AI-assistenten min betale fakturaer automatisk?
Nei. Assistent-API-et inneholder ingen verktøy for betaling eller pengeoverføring. Fakturaer kan kun leses, og betalingen foretar du selv i kundeportalen.
Hva skjer når jeg når min månedlige enhetskvote?
Hver plan har et månedlig enhetsbudsjett for hele kontoen. En lesing koster 1 enhet og en skriveforhåndsvisning 3 enheter. Når kontoens bruk i måneden når planens budsjett, returnerer påfølgende kall en quota_exceeded-feil i verktøyresultatet (HTTP 200, ikke 429) til UTC-kalendermåneden skifter.
Hvordan tilbakekaller jeg en kompromittert assistentnøkkel?
Åpne Assistenttilgang i kundeportalen, velg Tilbakekall nøkkel og bekreft. Alle etterfølgende forespørsler med denne nøkkelen avvises umiddelbart. OAuth-tilkoblede assistenter kan kobles fra på samme side.
Må jeg kjøre en lokal bro for å koble til ChatGPT?
Nei. Endepunktet er et vanlig HTTPS-endepunkt: klienten sender JSON-RPC via POST og mottar JSON. Skybaserte assistenter kobler seg til direkte uten lokal programvare.
Klar til å sette assistenten din i arbeid?
Velg et abonnement for å komme i gang, eller åpne kundeportalen og opprett en assistentnøkkel.