API (Application Programming Interface)

Uma API é uma interface padronizada que permite que dois programas comuniquem entre si. Define exatamente que dados um programa pode pedir e em que forma recebe a resposta — como um empregado de mesa que faz a ponte entre o cliente (o seu software) e a cozinha (a nossa plataforma).

O que é uma API?

API significa «Application Programming Interface» (interface de programação de aplicações). Uma API é a linguagem acordada que dois sistemas de software usam para trocar informação. Não é um programa que você opera, mas um contrato: «Se me enviares A, eu devolvo-te B».

Imagine um restaurante. Como cliente, você não vê a cozinha. Fala com o empregado de mesa. O empregado conhece o menu (= a documentação da API), recebe o seu pedido num formato fixo («massa com molho de tomate») e traz o resultado. A cozinha pode mudar — novos chefs, novos equipamentos — e enquanto o empregado mantiver o mesmo menu, a sua experiência mantém-se. É exatamente assim que uma API separa o que o seu software pede da forma como o serviço subjacente entrega.

Por que as APIs são importantes

As APIs são a espinha dorsal invisível do software moderno. Quando a sua ferramenta de contabilidade fala com a Stripe, quando a sua loja online consulta inventário em tempo real, quando o seu site incorpora o Google Maps — há uma API a correr nos bastidores. Sem APIs, cada empresa teria de construir todas as funcionalidades sozinha. Com APIs, juntam-se serviços especializados como blocos de construção.

A API no contexto SendSeven

A SendSeven expõe uma API que permite ao seu software enviar mensagens, gerir contactos e ler conversas — através do WhatsApp, SMS, e-mail, Telegram, Instagram, Messenger e chat ao vivo. Três exemplos concretos:

  • Loja online: Após cada encomenda, a sua loja envia automaticamente uma confirmação por WhatsApp — sem escrita manual.
  • CRM: No momento em que um lead passa a estado «quente», o CRM dispara uma mensagem personalizada pelo canal preferido do cliente.
  • Helpdesk: As mensagens WhatsApp recebidas chegam como tickets ao seu sistema de helpdesk — via webhook no sentido inverso.

Tipos de APIs

Nem todas as APIs funcionam da mesma forma. As variantes mais comuns:

  • REST API: O padrão atual para APIs web. Usa HTTP como um navegador, fácil de usar, suportada por todos os kits de programação. A SendSeven usa REST.
  • GraphQL: Uma variante em que o cliente especifica exatamente quais campos quer receber. Mais eficiente para modelos de dados complexos.
  • WebSocket: Para ligações em tempo real onde o próprio servidor envia eventos (por exemplo, «nova mensagem recebida»).
  • MCP Server: Um tipo de interface mais recente, desenhado especificamente para agentes de IA como Claude ou GPT.

Autenticação: quem pode fazer o quê?

As APIs não são abertas ao público. Cada chamada tem de se identificar. A SendSeven usa uma API Key — um token secreto e pessoal que funciona como uma palavra-passe. Quem tem a chave pode agir em seu nome. Por isso, uma chave API nunca deve estar no frontend, nem num repositório público do GitHub, nem num e-mail.

O que acontece quando algo corre mal?

Cada API responde com um código de estado. 200 OK significa que está tudo bem. 401 significa que a autenticação falhou. 429 significa demasiados pedidos — ver rate limiting. 500 significa um erro do servidor. Uma boa integração verifica o código de estado e reage com bom senso — por exemplo, tentando de novo após uma pausa curta.

API vs Conector vs SDK

Estes três termos são frequentemente confundidos:

  • API: A interface em bruto — chamadas HTTP, respostas JSON. Requer conhecimentos de programação.
  • SDK: Uma biblioteca pré-construída (em Python, JavaScript, PHP…) que simplifica a API para programadores.
  • Conector: Uma integração pronta a usar para um sistema de terceiros específico (por exemplo, o conector da Shopify). Muitas vezes utilizável sem código.

Preciso de uma API enquanto PME?

Resposta curta: apenas se quiser automatizar algo que não seja possível de raiz. A SendSeven oferece três caminhos, consoante o seu nível técnico:

  1. Plataforma: Clicar em vez de programar — a opção padrão para apoio ao cliente e marketing.
  2. Conectores: Integrações prontas para Shopify, HubSpot, Zapier, etc. — geralmente sem código.
  3. API: Para fluxos de trabalho à medida, software próprio ou operações em massa.