Anslut Tiny Ant till dina egna verktyg
REST-API, MCP-server och webhooks
Använd REST-API:et för att arbeta med affärsmöjligheter, kontakter, uppgifter, offerter och besöksdata från webbplatsen. MCP-servern gör ett urval av dessa åtgärder tillgängliga för kompatibla assistenter. En API-nyckel kan både läsa och ändra data i arbetsytan, så anslut bara verktyg du litar på.
Autentisering
Varje anrop skickar med en API-nyckel för arbetsytan i headern Authorization:
Authorization: Bearer ta_live_...Administratörer i arbetsytan skapar nycklar på sidan Inställningar i appen (avsnittet API och MCP). En nyckel visas en gång när den skapas och kan återkallas när som helst. Om den som skapat nyckeln ändras till medlem återkallas personens nycklar permanent; om skaparen tas bort blir nycklarna ogiltiga. Att ge tillbaka administratörsrollen återställer inte gamla nycklar. Nycklar kan inte användas medan arbetsytan är avstängd. Nyckeln agerar i den administratörs namn som skapade den: anteckningar, uppgifter och händelser tillskrivs den personen, och allt som nyckeln skapar är synligt för hela arbetsytan. API och MCP-server ingår i Pro och Team. Skapa och hantera nycklar under Inställningar → API och MCP.
Anrop utan giltig nyckel får 401. En arbetsyta med paketet Free får 403.
Bas-URL
https://app.tinyant.io/api/v1De flesta anropskroppar och svar använder JSON (UTF-8). Uppladdning av offerter använder multipart form data enligt tabellen nedan. ID-värden börjar med de_, co_, pe_, ta_ eller no_ följt av 12 tecken; offert-ID:n består av 12 tecken utan prefix. Tidsstämplar anges i Unix-millisekunder. Slutpunkterna nedan beskriver det publicerade integrationsgränssnittet. Använd appens nätverksanrop som exempel där en fullständig nyttolast inte dokumenteras här.
Slutpunkter
| Metod | Sökväg | Vad den gör |
|---|---|---|
| GET POST PUT DELETE | /automations, /automations/:id | CRM Advanced: administratörsregler och de 100 senaste tillgängliga körningarna. POST/PUT kräver name, definition, confirmation från förhandsvisning, revision (0 för ny) samt mode off|simulate|live. Börja med simulate; live kräver en lyckad simulering av den oförändrade versionen. API-regler förblir knutna till sin ursprungliga administratör och nyckel. Ägarskapsåtgärder kan endast utföras i appen. DELETE arkiverar regeln och avbryter väntande körningar. |
| POST | /automations/preview | Validera {definition}: version:1; trigger deal_created|stage_changed|stalled|proposal_opened; valfritt pipeline_id, stage_id, owner_id; stalled after_days 1..90. En åtgärd: create_task {title,delay_days:0..90,assignee_id}, set_field {field:expected_close,value:YYYY-MM-DD} eller notify {assignee_id}. Mottagare (assignee) är ett aktuellt medlems-ID eller deal_owner. Returnerar confirmation och högst 20 matchande exempel. Inga ändringar görs. |
| POST | /automations/:id/simulate, /automations/:id/stop, /automations/:id/cancel | Köa en simulering {deal_id}, stoppa en regel {} eller avbryt en väntande körning {run_id}. Bakgrundskörningen kontrollerar aktuella behörigheter på nytt. Ändringar och kvitton sparas atomärt; omförsök upprepar aldrig en redan utförd åtgärd. Inga utgående mejl skickas. |
| GET | /automation-notifications | Intern inkorg för aktuell användare, filtrerad efter nuvarande behörighet till affärsmöjligheter. Inga mejl- eller pushaviseringar i webbläsaren. |
| GET PUT | /dashboard | Personlig instrumentpanel: GET hämtar kortkatalog, sparad konfiguration och nyckeltal i realtid utifrån behörighet; PUT {revision,config} sparar endast den aktuella användarens layout och filter. Konfigurationsversion 1: days 7/30/90, owner all/mine/unassigned, valfritt pipeline_id och currency samt unika kort {id,size} från katalogen med bredderna 4/6/8/12. Prognos och utfall kräver administratörsbehörighet med Advanced; Visitors kräver ett betalt paket. Data sparas aldrig tillsammans med layouter. API-nycklar behåller sin befintliga postomfattning. |
| GET | /bulk | Aktuella medlemmar, aktivitetsinställningar och dina 20 senaste masskörningar. Förhandsvisning och status för masskörningar är begränsade till skaparen och samma API-nyckel. |
| POST | /bulk/preview | Förhandsvisa 1 till 100 specifika företag, personer eller affärsmöjligheter med entity, ids och action: activity, plus aktivitetsfält på samma sätt som när uppgifter skapas. Returnerar valda namn, validering per post och confirmation. Skapande av aktiviteter använder aktuella redigeringsrättigheter och samma kontroller för schemaläggning, Advanced-typer och kapacitet som enskilda aktiviteter. Byte av ansvarig kan endast göras i appen av administratörer, i enlighet med hanteringen av postbehörigheter. |
| GET POST | /bulk/:id | Läs in en förhandsvisning/resultat eller skicka POST med dess confirmation för att tillämpa upp till fem rader atomärt per anrop. Upprepa samma ID/hash tills allt är klart; slutförda rader körs aldrig igen. Resultat anges som applied, skipped, failed eller pending. Ändringar i CRM eller behörigheter gör väntande arbete ogiltigt. Kontrollera resultaten och förhandsvisa endast återstående poster. Upp till 100 sparade omgångar per arbetsyta, tillgängliga i sju dagar och därefter borttagna vid schemalagd rensning eller nästa förhandsvisning av massändring. Radering av ägare eller arbetsyta tar även bort förhandsvisningar och kvitton. Inga mejl eller inbjudningar skickas. |
| GET | /imports/catalog | Fält- och pipelinekatalog för importmappning. Alla CRM-medlemmar kan förhandsvisa och importera; konfigurering av anpassade fält och extra pipelines kräver fortfarande Advanced. |
| POST | /imports/preview | Förhandsvisa 1 till 100 rader (upp till 500 KB) med kind och duplicates: fill eller skip. Stöder custom_fields via stabilt ID, pipeline-/steg-ID:n eller entydiga namn samt explicita post-ID:n. Alternativet fill fyller endast i tomma värden; befintligt belopp, status och steg för en affärsmöjlighet ändras inte. Upprepade poster hoppas över. Inga CRM-poster ändras under förhandsvisningen. Returnerar radåtgärder/fel, batch-ID och bekräftelsehash. Förhandsvisningsplaner och omförsökskvitton löper ut efter sju dagar och tas bort vid schemalagd rensning eller nästa import i arbetsytan. |
| GET POST | /imports/:id | Endast omgångens ägare kan läsa eller återuppta den. POST med confirmation från den granskade förhandsvisningen tillämpar upp till tio rader, var och en atomärt inklusive relaterade kontakter, fält, anteckningar och historik. Upprepa samma ID/hash tills allt är klart; slutförda rader körs aldrig igen. Samtidiga ändringar i CRM avvisar inaktuella förhandsvisningar: läs av next_row och förhandsvisa därefter endast återstående rader. Upp till 100 sparade omgångar per arbetsyta. |
| POST | /import | Äldre direktimport utan säker omkörning; föredra /imports/preview. Importera upp till 500 företag, personer eller affärsmöjligheter; returnerar created, updated, skipped, trimmed och numrerade radfel. Befintliga kontakter kan kompletteras även vid full kapacitet. |
| PUT | /deals/:id | Använd before_id (en affärsmöjlighet i målsteget, eller null för sist), stage_id och revision för att ändra ordning. Kortordningen påverkar inte tiden i steget. |
| POST | /deals/move | Förhandsvisa eller genomför flytt av upp till 100 öppna affärsmöjligheter: deal_ids, pipeline_id, stage_id, preview. Genomför med returnerad preview_hash. Inaktuella förhandsvisningar avvisas; resultat redovisas per affärsmöjlighet. |
| GET POST | /views/:entity | Sparade vyer för affärsmöjligheter, personer eller företag. GET returnerar läsbara vyer, fält-/operatorkatalog och standardvärden. Användare med Advanced kan skapa privata vyer; administratörer kan skapa vyer för hela arbetsytan. Skicka POST med name, sharing (private/workspace), revision:0 och definition {version:1, columns, sort, filter}. Delning i arbetsytan utökar aldrig datatillgången. |
| PUT | /views/:entity/:id | Uppdatera en vy med dess förväntade revision. Delningsnivån (sharing) kan inte ändras; spara en kopia om du vill byta den. Endast ägaren kan uppdatera en privat vy; endast administratörer kan uppdatera delade vyer. archived:true döljer en vy. Upp till 100 aktiva vyer per arbetsyta. |
| POST | /query/:entity | En validerad fråga för listor och CSV-sidor. Skicka definition eller view_id, offset (0..100000), limit (1..100) och format (json/csv). Definition: version:1, columns (1..20 ID:n), sort (upp till 3 {field,direction}-poster), filter {op:and/or,rules:[groups or {field,op,value}]}. Upp till 20 noder och djup 3. Värden skickas som bundna parametrar, aldrig som SQL. owner_id eq me matchar aktuell användare; value_cents anges i cent/ören. has_task inkluderar odaterade öppna uppgifter, next_task är den tidigaste daterade öppna uppgiften. Svaret innehåller total, next_offset och rader eller formelsäker CSV. I CSV ersätts val-ID:n med etiketter. Tomma jämförelser använder empty/not_empty; övriga jämförelser exkluderar saknade värden. Vyer och export förblir läsbara även om tillgången till Advanced upphör. Sidindelning sorteras med ID som utslagsregel, men utgör inte en låst ögonblicksbild mellan separata anrop. |
| GET PUT | /layouts/:entity | Delad kortlayout för företag, personer eller affärsmöjligheter. GET returnerar layout, standardvärden, revision, schema_revision och fält. Administratörer med Advanced kan skicka PUT med layout {main, side, details}, båda revisionerna och samtliga fält som ordnade {id, group_name}-objekt, inklusive arkiverade fält. Varje sektion och detaljnyckel måste förekomma exakt en gång; ingen HTML och inga dolda sektioner tillåts. Medlemmar och arbetsytor utan Advanced behåller läsbehörighet. |
| GET POST | /fields/:entity | Lista eller skapa anpassade fält för företag, personer eller affärsmöjligheter. Att skapa kräver administratörsbehörighet med Advanced. Typer: text, long_text, number, date, boolean, select, multi_select. Valfri group_name och position. |
| PUT | /fields/deals/:id/rules | Administratör med Advanced: förhandsvisa och ersätt omfattning för visible_in/required_in (pipeline_id, valfritt stage_id). Kräver fältets revision, först preview:true och därefter preview:false med returnerad preview_hash. Tom visible_in innebär överallt; obligatoriska fält förblir synliga. Förhandsvisningen redovisar befintliga öppna affärsmöjligheter som saknar värden. |
| PUT | /fields/:entity/:id | Uppdatera name, group_name, position, archived och options med förväntad revision. Befintliga fälttyper kan inte ändras. Skapande av affärsmöjlighet tar emot custom_fields nycklade med fält-ID; om obligatoriska stegvärden saknas returneras 422 vid skapande, stegändring och återöppning, även via import och MCP. Alternativ behåller sina ID:n; utelämnade äldre val arkiveras. |
| GET PUT | /:entity/:id/fields | Läs eller uppdatera typade värden via fält-ID. PUT kräver values, revision och schema_revision från GET; null rensar ett värde. Valfält använder alternativ-ID:n. Arkiverade fält förblir läsbara. Dessa slutpunkter stöder ännu inte obligatoriska eller stegspecifika fält. |
| GET POST | /pipelines | Lista pipelines (inklusive arkiverade) eller skapa en ny (name; kräver administratör med Advanced) |
| PUT | /pipelines/:id | Uppdatera name, position, make_default eller archived med förväntad revision. Flytta eller avsluta öppna affärsmöjligheter före arkivering; /deals/move ger en förhandsvisning och resultat per affärsmöjlighet. |
| GET | /reports | Rapporttyper, beräkningsnoteringar, filter och personliga sparade rapporter (administratör med Advanced) |
| POST | /reports/run | Kör definition eller view_id med aktuella postbehörigheter. Valfri group från svaret, offset samt limit upp till 100. Belopp i cent/ören hålls isär per valuta. |
| POST PUT | /reports/views, /reports/views/:id | Spara en personlig rapport: name, definition, revision (0 för ny); archived:true döljer en befintlig rapport |
| GET | /capabilities | Aktuella funktionsrättigheter och tillåtna åtgärder i CRM; detta innebär inte att varje funktion är implementerad |
| GET | /me | Arbetsyta, paket och den användare som nyckeln agerar som |
| GET | /deals?status=open|won|lost&q=&pipeline_id= | Lista affärsmöjligheter med steg, värde, företag, kontakt och lässtatus för offert |
| POST | /deals | Skapa en affärsmöjlighet (name, company_id eller company_name, person_id, value, currency, pipeline_id, stage_id, expected_close) |
| GET PUT DELETE | /deals/:id | En affärsmöjlighet med tidslinje; uppdatera fält, steg eller status; valfria close_details i Advanced eller next_activity vid återöppning, med revision; radera |
| POST | /deals/:id/proposals | Koppla en offert till affärsmöjligheten ({proposal_id}) |
| DELETE | /deals/:id/proposals/:pid | Koppla loss en offert |
| GET POST | /companies | Lista eller skapa företag |
| GET PUT DELETE | /companies/:id | Ett företag med personer, affärsmöjligheter och tidslinje |
| GET POST | /people | Lista eller skapa personer (kontakter) |
| GET PUT DELETE | /people/:id | En person med affärsmöjligheter och tidslinje |
| GET PUT | /activity-settings | Läs eller ange din IANA-tidszon; administratörer kan även ange workspace_timezone. Null använder standardvärdet. |
| GET POST | /tasks | Lista eller skapa aktiviteter. scope=mine|all|unassigned, status=open|done|cancelled|all (äldre done=0|1|all), post-ID:n, offset och limit (max 500). Följ next_offset när has_more är satt. |
| GET PUT DELETE | /tasks/:id | Läs, redigera, slutför, avbryt eller radera en aktivitet. Stöd för anteckningar, completed_date, call_result och atomär next_activity. Skicka med revision vid redigering och ?revision= vid radering; inaktuella skrivningar returnerar 409. |
| POST | /notes | Lägg till en anteckning på en affärsmöjlighet, en person eller ett företag |
| PUT DELETE | /notes/:id | Redigera eller radera en anteckning |
| GET | /stages?pipeline_id= | Steg i pipeline, medlemmar och valuta (standardpipeline om inget anges) |
| PUT | /stages | Spara steg med pipeline_id och revision. Steg som används måste först få sina öppna affärsmöjligheter flyttade eller avslutade. Utelämnade steg arkiveras. |
| GET | /activity?since=&limit=&deal_id=&person_id=&company_id= | Strukturerad händelselogg, nyaste först. since är en tidsstämpel i Unix-millisekunder |
| GET | /search?q= | Företag, personer och affärsmöjligheter i en och samma sökning |
| GET | /visitors?days=7|30|90 | Tiny Ant Visitors: företag som har besökt din webbplats, sidor, senaste besök, CRM-koppling samt andelen besök från hem-, mobil- och datacenternätverk |
| GET POST | /visitors/settings | Status och kodsnutt för Visitors; slå på eller av ({enabled}), anslut eller ta bort ipapi.is ({ipapi_key}) |
| POST | /visitors/companies/:id/add | Lägg till ett besökande företag i CRM |
| GET | /proposals?status=active|won|closed|archived | Offerter med besök, lästid och kopplad affärsmöjlighet |
| GET | /proposals/:id | En offert med lästid per sida, mottagare, aktivitet och versioner |
| POST | /proposals | Ladda upp en offert (samma anropskropp som i appen: multipart med PDF-fil, namn och sidor) |
| POST | /proposals/:id/status | Ange status ({status: active|closed|won}) |
Aktiviteter
Slutpunkterna för uppgifter lagrar även samtal, möten och uppföljningar för arbetsytor med CRM Advanced i Team, Enterprise eller en aktiv pilot. Skicka activity_type (task, call, meeting eller follow_up), due_date (YYYY-MM-DD), valfri due_time (HH:mm), timezone (IANA-namn), duration_minutes (1 till 1440), assignee_id samt valfritt deal_id, person_id eller company_id. Heldagsuppgifter behåller sitt kalenderdatum. Om tidszon saknas används i första hand användarens inställning, därefter arbetsytans och sist UTC. En ogiltig lokal tid avvisas; en dubblerad tid kräver occurrence: earlier eller later. Läs in en aktivitet innan du redigerar den och skicka med dess revision; inaktuella ändringar returnerar 409. Äldre klienter kan utelämna revision. Null rensar valfria fält. Lista med scope=mine, all eller unassigned, done=0, 1 eller all, valfria post-ID:n, limit upp till 500 och offset; följ next_offset när has_more är true. Om tillgången till Advanced upphör kan befintliga typade aktiviteter fortfarande redigeras och slutföras, och nya grundläggande uppgifter kan skapas som vanligt. Aktiviteter ringer inte samtal, skickar inte meddelanden och bjuder inte in till möten. Att slutföra en aktivitet markerar inte en affärsmöjlighet eller offert som vunnen.
Registrera kontakt via mejl, SMS, LinkedIn eller annan kanal som activity_type: follow_up med contact_channel: email, sms, linkedin eller other (Advanced). Aktivitetsanteckningar rymmer upp till 10 000 tecken. done: true registrerar slutförande; completed_date anges som YYYY-MM-DD, senast idag. För att slutföra ett samtal krävs call_result: answered, no_answer eller busy. cancelled: true avbryter utan att radera; done och cancelled kan inte båda vara true. Lista med status: open, done, cancelled eller all; avbrutna poster ingår inte i öppna arbetslistor och aktivitetsrapporter.
En skrivåtgärd för en aktivitet kan innehålla next_activity: {title, due_date, activity_type, contact_channel, notes, assignee_id}; den nya posten ärver affärsmöjligheten och datumet måste vara idag eller senare. Kombinerade skrivningar på en befintlig post kräver revision. Båda ändringarna genomförs atomärt. En administratör med Advanced kan aktivera require_next_activity på en pipeline. En öppen affärsmöjlighet måste då ha kvar en öppen aktivitet när dess sista aktivitet slutförs, avbryts, tas bort eller kopplas loss, samt när affärsmöjligheten öppnas på nytt. Det är fortfarande tillåtet att skapa eller flytta en affärsmöjlighet utan aktivitet. Kravet slutar gälla om tillgången till Advanced upphör.
Uppdateringar av affärsmöjligheter i Advanced kan innehålla close_details med status won eller lost och revision: close_date (senast idag), open_activities (keep eller cancel), valfria notes samt won_reason vid vinst eller loss_category vid förlust. Förlustkategorier är price, timing, no_need, competitor, no_response, no_authority_or_budget, in_house, poor_fit och other. Valfri competitor gäller kategorin competitor; revisit_date måste vara ett framtida datum och skapar ingen påminnelse. Statusen won kräver ett positivt värde på affärsmöjligheten. Avslutning och eventuell avbokning av aktiviteter sparas tillsammans enligt gällande postbehörigheter. För att öppna igen skickar du status: open och vid behov next_activity. Vid återöppning rensas avslutsdetaljerna, men avbrutna aktiviteter återställs inte. Äldre uppdateringar med enbart status stöds fortfarande.
Exempel
Lista öppna affärsmöjligheter:
curl https://app.tinyant.io/api/v1/deals?status=open \
-H "Authorization: Bearer ta_live_..."Skapa en affärsmöjlighet och låt Tiny Ant skapa eller matcha företaget via namn:
curl -X POST https://app.tinyant.io/api/v1/deals \
-H "Authorization: Bearer ta_live_..." \
-H "Content-Type: application/json" \
-d '{"name": "Website redesign", "company_name": "Acme Ltd", "value": 12500}'Allt som har hänt sedan en viss tidsstämpel, till exempel för att synkronisera ditt eget system:
curl "https://app.tinyant.io/api/v1/activity?since=1760000000000&limit=100" \
-H "Authorization: Bearer ta_live_..."MCP-server
MCP-servern (Model Context Protocol) finns på:
https://app.tinyant.io/mcpTransportprotokollet är Streamable HTTP, tillståndslöst, med JSON-RPC över POST. Autentisering sker med samma Bearer-nyckel. Det finns inga serverinitierade strömmar, så det räcker med en vanlig HTTP-klient.
Claude Code. En rad i terminalen, sedan kan du fråga Claude om dina affärsmöjligheter:
claude mcp add --transport http tiny-ant https://app.tinyant.io/mcp --header "Authorization: Bearer ta_live_..."Andra MCP-klienter. Använd en klient som stöder Streamable HTTP och en anpassad Authorization-header. Ange server-URL:en till adressen ovan och headervärdet till Bearer följt av din API-nyckel. Kontrollera klientens aktuella anslutningsalternativ. Där direkt MCP-stöd saknas kan en egen integration anropa REST-API:et. Tiny Ant tillhandahåller inte färdiga integrationer för alla klienter.
OAuth. Den publicerade MCP-anslutningen i Tiny Ant använder för närvarande en statisk Bearer-nyckel. En klient som kräver OAuth kan inte använda anslutningen direkt. Kontrollera kompatibiliteten innan du väljer klient.
MCP-verktyg
Varje verktyg anropar samma API som ovan och returnerar JSON-svaret som text.
| Verktyg | Beskrivning |
|---|---|
search | Sök efter företag, personer och affärsmöjligheter i CRM via namn, e-post eller domän. |
list_deals | Lista affärsmöjligheter. |
get_deal | Fullständig vy över en affärsmöjlighet: detaljer, företag, kontakt, offerter med läsdata, uppgifter samt tidslinjen med anteckningar och händelser. |
create_deal | Skapa en affärsmöjlighet. |
update_deal | Uppdatera en affärsmöjlighet: byt namn, ändra värde, flytta till ett steg, markera som vunnen eller förlorad, koppla ett företag eller en kontakt. |
list_companies | Lista företag med antal personer, öppna affärsmöjligheter och öppet värde. |
get_company | Ett företag med dess personer, affärsmöjligheter och tidslinje. |
create_company | Skapa ett företag. |
list_people | Lista personer (kontakter), valfritt för ett specifikt företag. |
get_person | En person med affärsmöjligheter och tidslinje. |
create_person | Skapa en kontakt. |
add_note | Lägg till en anteckning på en affärsmöjlighet, en person eller ett företag. |
list_tasks | Lista öppna uppgifter för nyckelns ägare (mine) eller för alla. |
create_task | Skapa en uppgift, valfritt kopplad till en affärsmöjlighet, en person eller ett företag. |
get_task | Läs in en aktivitet inklusive dess revision. |
update_task | Redigera en aktivitet. |
get_activity_settings | Läs in gällande tidszon för aktiviteter och tillgängliga aktivitetstyper. |
complete_task | Markera en uppgift som slutförd (eller öppna den igen med done=false). |
get_crm_capabilities | Aktuella funktionsrättigheter och tillåtna åtgärder i CRM för denna användare. |
list_stages | Steg i en pipeline (standardpipeline om inget anges), arbetsytans medlemmar och valuta. |
move_deals | Förhandsvisa eller genomför en flytt av upp till 100 öppna affärsmöjligheter. |
get_dashboard | Läs in din personliga instrumentpanel med nyckeltal i realtid utifrån dina behörigheter. |
save_dashboard | Spara din egen layout och dina filter för instrumentpanelen med en revision från get_dashboard. |
list_automations | Läs in dina API-nyckelbundna automatiseringsregler och de senaste tillgängliga körningsresultaten. |
preview_automation | Validera en regel och förhandsvisa matchande öppna affärsmöjligheter utan att göra ändringar. |
save_automation | Skapa eller redigera en regel med bekräftelsen från förhandsvisningen. |
simulate_automation | Köa en simulering för en aktuell matchande affärsmöjlighet. |
stop_automation | Stäng av en regel och avbryt dess väntande körningar. |
archive_automation | Arkivera en regel och avbryt dess väntande körningar. |
cancel_automation_run | Avbryt en väntande körning. |
list_automation_notifications | Läs dina interna automatiseringsaviseringar utifrån nuvarande behörighet till affärsmöjligheter. |
list_reports | Läs in rapporttyper, beräkningsnoteringar, filter och personliga sparade rapporter (administratör med Advanced). |
run_report | Kör en rapport med aktuella postbehörigheter. |
save_report | Spara en personlig rapportdefinition. |
list_views | Lista läsbara sparade vyer, fält-/operatorkatalog och standardvärden. |
query_records | Bläddra i en validerad CRM-vy. |
preview_bulk_change | Förhandsvisa 1 till 100 valda CRM-poster. |
get_bulk_change | Läs in din förhandsvisning av massändringar och beständiga radresultat under sju dagar med samma API-nyckel. |
apply_bulk_change | Tillämpa upp till fem förhandsvisade rader atomärt per rad. |
preview_import | Förhandsvisa upp till 100 CRM-rader utan att ändra några poster. |
get_import | Läs in din importförhandsvisning och beständiga status; omgångar löper ut efter sju dagar. |
apply_import | Tillämpa upp till tio förhandsvisade rader atomärt per rad. |
save_view | Skapa eller uppdatera en personlig vy, eller en vy för hela arbetsytan som administratör (Advanced). |
get_card_layout | Läs in delade kortsektioner, detaljordning och grupper av anpassade fält. |
set_card_layout | Ersätt delad kortlayout och grupper av anpassade fält (administratör med Advanced). |
list_fields | Lista definitioner av anpassade fält, inklusive arkiverade fält och stabila alternativ. |
create_field | Skapa ett anpassat fält (administratör med Advanced). |
update_field | Byt namn på, ändra ordning på, gruppera eller arkivera ett fält (administratör med Advanced). |
set_field_rules | Förhandsvisa eller spara synlighet och obligatorisk omfattning för fält på affärsmöjligheter (administratör med Advanced). |
get_record_fields | Läs in en posts anpassade fält, värden och revision. |
set_record_fields | Uppdatera värden i anpassade fält via fält-ID. |
list_pipelines | Lista arbetsytans pipelines, inklusive arkiverade, samt standardpipelinen. |
create_pipeline | Skapa en pipeline med fyra inledande steg. |
update_pipeline | Byt namn på, ändra ordning på, arkivera eller ange en pipeline som standard. |
set_stages | Ersätt aktiva steg i en pipeline. |
activity | Strukturerad händelselogg för arbetsytan, nyaste först: skapade och flyttade affärsmöjligheter, vunna och förlorade, anteckningar, uppgifter samt kopplade och lästa offerter. |
list_proposals | Offerter med lässtatus: besök, total lästid, läser nu och kopplad affärsmöjlighet. |
get_proposal | En offert: lästid per sida, mottagare, aktivitet, versioner och kopplad affärsmöjlighet. |
list_visitors | Företag som har besökt din webbplats (Tiny Ant Visitors): namngivna företagsnätverk med visade sidor, senaste besök och eventuellt kopplat CRM-företag, samt hur många besök som kom från hem-, mobil- eller datacenternätverk. |
link_proposal | Koppla en befintlig offert till en affärsmöjlighet så att läsningen visas på affärsmöjlighetens tidslinje. |
Anropsgränser och skälig användning
MCP tar emot ett JSON-RPC-meddelande per POST, upp till 512 KiB. JSON-arrayer avvisas utan att några verktyg körs. Skicka separata anrop. Icke-GET-anrop till CRM, inklusive importer, massåtgärder och förhandsvisningar av frågor, delar på en ytterligare kvot om 120 anrop per minut och arbetsyta över appen, REST och MCP; vid avvisning returneras 429 och Retry-After. Dessa gränskvoter är lokala per Cloudflare-nod.
Gränser för skälig lagring i CRM gäller per tabell (affärsmöjligheter, uppgifter och anteckningar): Free 500, Pro 20 000, Team och Enterprise 50 000. Free har även en separat gräns på 10 öppna affärsmöjligheter. Slutförda uppgifter och avslutade affärsmöjligheter räknas fortfarande in i lagringsgränserna; befintliga poster behålls när ett paket nedgraderas.
Mottagningen i Visitors är begränsad per arbetsyta och UTC-dygn: Pro 5 000, Team 20 000 och Enterprise 50 000 sidvisningar. Överskjutande trafik sparas inte; insamlingen återupptas nästa dag. Dygnstaket använder en delad databasräknare; kantskyddet begränsar dessutom en källadress till 60 och en publik Visitors-nyckel till 600 signaler per minut och Cloudflare-nod. En misslyckad uppslagning eller skrivning efter reservering kan förbruka en plats i dygnskvoten. Kundens kvot hos ipapi.is är separat.
Varje nyckel får göra 120 anrop per minut sammanlagt över REST-API:et och MCP-servern, och varje IP-adress 300 per minut. Anrop utan giltig nyckel är begränsade till 30 per minut och adress. Om en gräns överskrids får du 429 med en Retry-After-header; vänta och försök igen. Anropa /activity med since i stället för att läsa in hela listor på nytt, använd en separat nyckel per integration så att du kan återkalla den enskilt och dela aldrig en nyckel med personer utanför din arbetsyta. En arbetsyta kan ha upp till 10 aktiva nycklar.
Automatiseringsregler i CRM Advanced startar med simulering. Gränserna är 50 aktiva regler och 1 000 körningar per rullande 24 timmar och arbetsyta. Skapande av affärsmöjligheter och stegändringar köas atomärt. Bekräftade externa offertöppningar är begränsade till en per offert och UTC-dygn. Tidsgränser för avstannade affärsmöjligheter har ett uppsamlingsfönster på sju dagar. Körningar och interna aviseringar sparas i 90 dagar. Inga kunddata skickas till någon AI-modell eller extern meddelandetjänst.
Administratörer med Advanced kan köra rapporter för öppen pipeline, vunna/förlorade affärer och vinstfrekvens, steghistorik, aktiviteter samt viktad prognos. Datum anges som inkluderande UTC-dagar (upp till 366); planerade aktiviteter använder sitt eget förfallodatum. Prognoser bygger på aktuella öppna affärsmöjligheter och stegens sannolikheter, där odaterade affärsmöjligheter och valutor hålls isär. Baslinjeobservationer utgör inte historiska steginträden eller kända varaktigheter. Sparade personliga rapporter lagrar uro- och filterval, inte ögonblicksbilder av resultat. Varje körning och fördjupning tillämpar gällande postbehörigheter.
Med CRM Advanced tillämpas postbehörigheter genomgående i appen, REST, MCP och vid export. API-nycklar och webhooks omfattar som standard poster som delas med hela arbetsytan, inklusive delade överordnade poster. En administratör kan uttryckligen skapa en integration för arbetsytans samtliga poster, inklusive privata poster. Omfattningen visas i Inställningar. Befintliga begränsningar fortsätter att gälla även om tillgången till Advanced upphör. Publika mottagarlänkar för offerter förblir en separat delningskanal.
Webhooks
Om du vill att Tiny Ant ska anropa ditt system i stället ställer du in utgående webhooks på samma sida under Inställningar. De skickar en signerad JSON POST när en offert öppnas, när en läsning avslutas, när en status ändras och när en affärsmöjlighet skapas eller flyttas mellan steg.
Frågor
Skriv till hello@tinyant.io. Ändringar i API:et meddelas på den här sidan.