General Equipo Facturación Seguridad Messenger Instalación WhatsApp Dominios Tinkay AI Integraciones Datos de tu empresa Desarrolladores

Desarrolladores

API keys, webhooks, eventos y un playground para probar todo sin salir de acá.

Empezá con la API

REST, JSON, paginación por cursor. Autenticación con Bearer token.

GET /v1/contacts

curl https://api.tinkay.app/v1/contacts?limit=25 \
  -H "Authorization: Bearer dk_live_4f2a…" \
  -H "Accept: application/json"

Respuesta

{
  "object": "list",
  "data": [
    { "id": "ct_juan", "object": "contact", "name": "Juan Pérez", "email": "[email protected]", "country": "Argentina" }
  ],
  "next_cursor": "ct_camila",
  "has_more": true
}

Límite: 600 solicitudes por minuto por API key. Los encabezados X-RateLimit-* indican el estado. Versión de eventos 2026-09-01.Referencia completa

Ejemplos por lenguaje

El mismo pedido en cada stack: listar conversaciones abiertas y crear un contacto.

Ver documentación completa

TinkayClient.cs

1using System.Net.Http.Headers;2using System.Net.Http.Json;34var http = new HttpClient { BaseAddress = new Uri("https://api.tinkay.app/v1/") };5http.DefaultRequestHeaders.Authorization =6    new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("TINKAY_API_KEY"));7http.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));89// Conversaciones abiertas, 25 por página10var page = await http.GetFromJsonAsync<TinkayPage<Conversation>>("conversations?status=open&limit=25");11foreach (var c in page!.Data)12    Console.WriteLine($"{c.Id} · {c.Subject} · {c.Status}");1314// Crear un contacto15var created = await http.PostAsJsonAsync("contacts", new16{17    name = "Juan Pérez",18    email = "[email protected]",19    attributes = new { plan = "Pro" }20});21created.EnsureSuccessStatusCode();2223record TinkayPage<T>(T[] Data, string? NextCursor, bool HasMore);24record Conversation(string Id, string Subject, string Status);

La API key vive en una variable de entorno del servidor. Nunca la expongas en el navegador ni en apps móviles.

{ "object": "list", "data": [ { "id": "ct_juan", "object": "contact", "name": "Juan Pérez", "email": "[email protected]", "country": "Argentina" } ], "next_cursor": "ct_camila", "has_more": true }

1using System.Net.Http.Headers;2using System.Net.Http.Json;34var http = new HttpClient { BaseAddress = new Uri("https://api.tinkay.app/v1/") };5http.DefaultRequestHeaders.Authorization =6 new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("TINKAY_API_KEY"));7http.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));89// Conversaciones abiertas, 25 por página10var page = await http.GetFromJsonAsync<TinkayPage<Conversation>>("conversations?status=open&limit=25");11foreach (var c in page!.Data)12 Console.WriteLine($"{c.Id} · {c.Subject} · {c.Status}");1314// Crear un contacto15var created = await http.PostAsJsonAsync("contacts", new16{17 name = "Juan Pérez",18 email = "[email protected]",19 attributes = new { plan = "Pro" }20});21created.EnsureSuccessStatusCode();2223record TinkayPage<T>(T[] Data, string? NextCursor, bool HasMore);24record Conversation(string Id, string Subject, string Status);