Watengenezaji

Unganisha zana za community yako.

API ya group inaunganisha server au automation yako na taarifa za community zilizoidhinishwa. Kila credential ni ya group moja na ina ruhusa ambazo admin amechagua pekee.

Unda credential ya group

Fungua Pilot kupitia Telegram na uchague group ambalo wewe ni admin wake kwa sasa.
Fungua Zana za community → Miunganisho. Chagua jina, scopes unazohitaji tu na expiry ya siku 1 hadi 90.
Thibitisha, kisha nakili token inayoonyeshwa mara moja na uihifadhi kwenye secret store au mazingira salama ya server yako.
Tuma maombi kupitia server yako. Token isiwekwe kwenye chat, code ya public, JavaScript ya browser au URL. Ifute kupitia Miunganisho ikiwa haihitajiki tena.

Fungua zana za community

Ruhusa zinakaguliwa kwa kila ombi.

Pilot huhifadhi hash ya credential. Token iliyoisha au kufutwa haifanyi kazi, na aliyeitengeneza lazima aendelee kuwa admin wa group lake. Kutuma group ID tofauti kwenye ombi hakubadilishi group la token.

Chagua operation na scope yake

Operation	Scope inayohitajika	Matokeo
`knowledge`	knowledge:read	FAQ zilizoidhinishwa, zikiwa na chaguo la kutafuta kwa swali.
`events`	events:read	Taarifa za matukio ya group, bila utambulisho wa members walioitikia RSVP.
`draft`	drafts:write	Rasimu ya tangazo kwenye foleni ya mapitio ya admins wa group.

Tuma ombi

Tuma JSON kwenye endpoint hapa chini ikiwa na Authorization header. YOUR_GROUP_TOKEN ni mfano tu wa credential iliyohifadhiwa kwenye server yako.

POSThttps://pilot.sautilink.com/api/integrations

Tafuta majibu yaliyoidhinishwa

curl https://pilot.sautilink.com/api/integrations \
  --request POST \
  --header 'Authorization: Bearer YOUR_GROUP_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"operation":"knowledge","input":{"query":"registration"}}'

Unda rasimu ya tangazo

{
  "operation": "draft",
  "requestId": "YOUR_UNIQUE_REQUEST_ID",
  "input": {
    "title": "Community update",
    "text": "Our next community session is ready for review."
  }
}

Tumia requestId mpya ya nasibu yenye herufi, namba, underscore au hyphen 16–80 kwa kila rasimu. Unaporudia ombi, tumia ID ileile na body ileile. Body tofauti kwa ID ileile hukataliwa kama conflict.

Rasimu haitumwi moja kwa moja. Admin anaipitia kwenye Zana za community → Miunganisho. Approval huhifadhi uamuzi wa mapitio; admin huchagua hatua nyingine ya kutuma au kupanga post.

Inputs na mipaka

`knowledge`	input: {} au {"query":"swali lako"}; query hadi herufi 200.
`events`	input: {}.
`draft`	input: {"title":"Kichwa","text":"Ujumbe wa tangazo"}; title hadi herufi 120 na text hadi 3,500. requestId inahitajika.
`Maombi`	Maombi 60 kwa dakika kwa kila token.
`Rasimu`	Rasimu mpya 20 kwa token ndani ya saa 24 zinazohesabiwa kurudi nyuma; hadi rasimu 50 zinazosubiri kwa group.
`Credentials`	Expiry ya siku 1–90; hadi credentials 10 zilizo hai kwa group. Admin wa sasa anaweza kufuta credential.

Shughulikia response

Response iliyofanikiwa ina {"ok":true,"data":...}. Hitilafu ina {"ok":false,"error":"code"}. Kagua HTTP status kabla ya kutumia data.

`401`	Credential haipo, si sahihi, imeisha au imefutwa.
`403`	Scope inayohitajika haipo au mtengenezaji hana tena ruhusa.
`409`	Ombi linakinzana na la awali, bado linasubiri, au idadi inayoruhusiwa imefikiwa.
`429`	Umefikia idadi ya maombi au rasimu inayoruhusiwa. Subiri kabla ya kujaribu tena.
`503`	Pilot haikuweza kuthibitisha ruhusa au kukamilisha ombi. Unaporudia rasimu, tumia requestId na body zilezile.

Unahitaji integration nyingine?

Eleza mfumo na taarifa au hatua chache unazohitaji. Tumia zana ya maoni kupendekeza scopes na miunganisho zaidi.

Pendekeza feature au ripoti tatizo