API
1MSG SDK: chame a API do WhatsApp da sua linguagem
Um cliente 1MSG para TypeScript, Python, Go, Java, C# e mais. Mesma API do WhatsApp: instale a partir do registro, chame métodos, evite HTTP escrito à mão.
Nikita L ·
Se você já chama 1MSG via HTTP, isso ainda funciona. Os endpoints, tokens e formatos de resposta não mudam. O que há de novo é que você pode parar de montar esses pedidos manualmente.
Por que isso existe
Sem um SDK, cada chamada é uma requisição HTTP escrita à mão: URL, token, corpo JSON, seus próprios tipos e tratamento de erros. Você copia do Documentação da API e mantém tudo correto. O SDK é essa camada como um pacote na sua linguagem — você chama métodos contra a mesma API.
Os clientes são gerados a partir do mesmo contrato OpenAPI que o servidor, então eles seguem a API em vez de se desviar de um curl copiado. Esse era o objetivo do reconstrução do backend.
Comece aqui
Você precisa de três valores da página do canal: baseUrl, instanceId, e token. Depois disso, você chama um método, não uma URL. Se você ainda não tem um canal, o Início rápido abrange conta, canal de teste e a primeira mensagem.
TypeScript é o caminho mais curto. Instale com npm install @1msg/sdk, então:
import { createClient } from '@1msg/sdk';
const client = createClient({
baseUrl: 'https://api.1msg.io',
instanceId: 'YOUR_INSTANCE_ID',
token: process.env.MSG_API_TOKEN!,
});
await client.sendMessage({ body: 'Hello', chatId: '[email protected]' });As outras línguas funcionam da mesma maneira: as mesmas três credenciais, mesma sendMessage chamada. Os comandos de instalação e repositórios estão abaixo.
Instalar
A maioria das linguagens é instalada a partir de um repositório de pacotes. PHP e C++ são apenas de fonte por enquanto.
| Idioma | Instalar | Fonte |
|---|---|---|
| TypeScript | npm install @1msg/sdk | https://github.com/1msg/1msg-sdk/tree/main/typescript |
| Python | pip install one-msg-sdk | https://github.com/1msg/1msg-sdk/tree/main/python |
| Java | implementation("io.1msg:sdk") | https://github.com/1msg/1msg-sdk/tree/main/java |
| Kotlin | implementation("io.1msg:sdk-kotlin") | https://github.com/1msg/1msg-sdk/tree/main/kotlin |
| Scala | "io.1msg" %% "sdk-scala" | https://github.com/1msg/1msg-sdk/tree/main/scala |
| C# | dotnet add package OneMsg.Sdk | https://github.com/1msg/1msg-sdk/tree/main/csharp |
| Ruby | gem install one_msg_sdk | https://github.com/1msg/1msg-sdk/tree/main/ruby |
| Rust | cargo add one-msg-sdk | https://github.com/1msg/1msg-sdk/tree/main/rust |
| Go | go get github.com/1msg/1msg-sdk-go | https://github.com/1msg/1msg-sdk-go |
| Swift | SwiftPM: 1msg-sdk-swift | https://github.com/1msg/1msg-sdk-swift |
| PHP | composer require 1msg/sdk from GitHub (Packagist not published yet) | https://github.com/1msg/1msg-sdk-php |
| C++ | git clone + CMake (no registry yet) | https://github.com/1msg/1msg-sdk-cpp |
PHP do GitHub:
composer config repositories.1msg vcs https://github.com/1msg/1msg-sdk-php
composer require 1msg/sdkC++: git clone https://github.com/1msg/1msg-sdk-cpp.git
Escolha seu idioma, instale o pacote e envie a primeira mensagem com baseUrl, instanceId, e token a partir da página do canal. O HTTP bruto permanece inalterado — o SDK é a mesma API, como um cliente.