Autenticação
Saiba como gerar e utilizar seu token de acesso para autenticar as chamadas à API.
Visão Geral
Com a API do Tinko você pode integrar sua aplicação à plataforma de atendimento de forma programática: automatizar o envio de mensagens, gerenciar contatos, monitorar conversas, configurar webhooks para receber eventos em tempo real e muito mais.
Nos comunicamos via HTTP REST e retornamos as respostas em JSON. A autenticação é por Bearer Token, que você obtém nas configurações da sua conta.
URL base
https://api.tinko.com.br/v1Chame todos os endpoints a partir dessa URL base. Use HTTPS e inclua o header Authorization: Bearer <seu-token> em todas as requisições.
Por onde começar?
Status & Erros
Entenda os códigos de status HTTP, formatos de resposta e como tratar erros.
Limites de Requisições
Conheça os rate limits por endpoint e como evitar bloqueios.
Webhooks
Receba notificações em tempo real para mensagens, chats e outros eventos.
Padrões da API
Autenticação
Exigimos um Bearer Token no header Authorization em todas as requisições:
Authorization: Bearer <seu-token>Você gera o token nas configurações da sua conta Tinko. Veja Autenticação para mais detalhes.
Formato das Respostas
Nossas respostas são em JSON. Em sucesso, enviamos os dados no corpo. Em erro, retornamos um objeto com message descrevendo o problema.
Paginação
Nos endpoints de listagem, retornamos um objeto pagination com os campos:
| Campo | Descrição |
|---|---|
total | Total de registros encontrados |
per_page | Quantidade de itens por página |
current_page | Página atual |
last_page | Última página disponível |
Rate Limit
Aplicamos limites por endpoint. Veja Limites de Requisições para os detalhes de cada recurso.
Referência de Endpoints
Recursos Principais
| Recurso | Descrição |
|---|---|
| Canais | Liste os canais de comunicação disponíveis (WhatsApp, Instagram, etc.) |
| Chats | Gerencie conversas, transfira entre atendentes e canais |
| Mensagens | Envie mensagens e consulte histórico de conversas |
| Contatos | Crie e gerencie contatos, campos personalizados e notas |
| Tags | Organize contatos e chats com etiquetas |
| Usuários | Gerencie usuários e permissões da equipe |
| Templates | Veja templates de mensagens pré-aprovados |
Webhooks
| Tópico | Descrição |
|---|---|
| Configuração | Como configurar a URL de destino dos eventos |
| Eventos Suportados | Lista completa de eventos disponíveis |
| Práticas Recomendadas | Segurança, idempotência e tratamento de falhas |
MCP (Model Context Protocol)
| Tópico | Descrição |
|---|---|
| Introdução | O que é o MCP e como ele se integra ao Tinko |
| Configuração | Como conectar agentes de IA à API via MCP |
| Ferramentas Disponíveis | Lista de ferramentas expostas pelo servidor MCP |
Suporte
Se tiver problema ou dúvida, confira nossa página de contato ou o FAQ com as perguntas mais comuns.