SDK Overview - EnviaAI

Official SDKs

We provide official SDKs for the most popular programming languages. All SDKs are open source and actively maintained.

Node.js / TypeScript

Full TypeScript support with type definitions

npm install @enviaai/sdk

Python

Async support and type hints

pip install enviaai

Java

Java 11+ with builder pattern

<artifactId>enviaai-java</artifactId>

PHP

PHP 8.0+ with Laravel support

composer require enviaai/sdk

Features

All our SDKs include:

Type Safety

Full type definitions for TypeScript, Python type hints, and Java generics. Catch errors at compile time, not runtime.

Error Handling

Typed exception classes for different error scenarios: authentication, rate limits, validation, and server errors.

Automatic Retries

Built-in retry logic with exponential backoff for transient errors and rate limits.

Webhook Verification

Helper methods to verify webhook signatures and prevent spoofing.

Quick Comparison

Feature	Node.js	Python	Java	PHP
Async support	Promise	async/await	CompletableFuture	-
Type safety	TypeScript	Type hints	Generics	-
Min version	Node 16+	Python 3.8+	Java 11+	PHP 8.0+
Package manager	npm/yarn	pip	Maven/Gradle	Composer

Quick Start Examples

Node.js
Python
Java
PHP

import { EnviaAI } from '@enviaai/sdk';

const client = new EnviaAI({ apiKey: 'your-api-key' });

const response = await client.messages.send({
  instanceId: 'inst_abc123',
  to: '5511999999999',
  message: 'Hello from EnviaAI!'
});

from enviaai import EnviaAI

client = EnviaAI(api_key="your-api-key")

response = client.messages.send(
    instance_id="inst_abc123",
    to="5511999999999",
    message="Hello from EnviaAI!"
)

EnviaAI client = new EnviaAI("your-api-key");

SendMessageResponse response = client.messages().send(
    SendMessageRequest.builder()
        .instanceId("inst_abc123")
        .to("5511999999999")
        .text("Hello from EnviaAI!")
        .build()
);

use EnviaAI\EnviaAI;

$client = new EnviaAI('your-api-key');

$response = $client->messages->send([
    'instanceId' => 'inst_abc123',
    'to' => '5511999999999',
    'message' => 'Hello from EnviaAI!'
]);

Installation

Node.js
Python
Java
PHP

# npm
npm install @enviaai/sdk

# yarn
yarn add @enviaai/sdk

# pnpm
pnpm add @enviaai/sdk

# pip
pip install enviaai

# poetry
poetry add enviaai

# pipenv
pipenv install enviaai

<!-- Maven -->
<dependency>
    <groupId>com.enviaai</groupId>
    <artifactId>enviaai-java</artifactId>
    <version>1.0.0</version>
</dependency>

// Gradle
implementation 'com.enviaai:enviaai-java:1.0.0'

composer require enviaai/sdk

Using Raw HTTP

If you prefer not to use an SDK, you can call the API directly:

cURL

curl -X POST https://api.enviaai.app/v1/messages/send \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "instanceId": "inst_abc123",
    "to": "5511999999999",
    "message": "Hello from EnviaAI!"
  }'

Contributing

Our SDKs are open source! Contributions are welcome:

Support

GitHub Issues

Report bugs or request features

Discord

Get help from the community

SDKs

​Official SDKs

Node.js / TypeScript

Python

Java

PHP

​Features

​Quick Comparison

​Quick Start Examples

​Installation

​Using Raw HTTP

​Contributing

​Support