PHPackages                             integrax/integrax-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail & Notifications](/categories/mail)
4. /
5. integrax/integrax-php

ActiveLibrary[Mail & Notifications](/categories/mail)

integrax/integrax-php
=====================

Send SMS, RCS & OTP messages via API. Bulk SMS, OTP verification, phone number lookup — zero dependencies.

11↓100%PHP

Since Apr 12Pushed 1mo agoCompare

[ Source](https://github.com/IntegraX-lat/integrax-php)[ Packagist](https://packagist.org/packages/integrax/integrax-php)[ RSS](/packages/integrax-integrax-php/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependenciesVersions (1)Used By (0)

integrax-php
============

[](#integrax-php)

SDK oficial da Integrax para PHP — SMS, RCS, OTP e consultas via API REST.

- Zero dependencias (usa `curl` nativo)
- PHP 8.1+ com named arguments, readonly properties
- PSR-4 autoload

Obtendo seu token
-----------------

[](#obtendo-seu-token)

1. Crie uma conta gratuita em [integrax.app](https://integrax.app)
2. Após o cadastro, acesse o menu **API** e crie um token

Pronto, você já pode integrar!

> Se receber `MESSAGE_NOT_ALLOWED`, entre em contato com o suporte pelo [WhatsApp](https://wa.me/551132808396) e solicite a liberação.

Instalacao
----------

[](#instalacao)

```
composer require integrax/integrax-php
```

Quick start
-----------

[](#quick-start)

```
require_once 'vendor/autoload.php';

use Integrax\Integrax;

$ix = new Integrax("seu-token-aqui");

// Enviar SMS
$res = $ix->sms->send(["5511999999999"], "Pedido #4821 confirmado!");
echo $res["data"][0]["messageId"]; // "82816396"
```

Configuracao
------------

[](#configuracao)

```
$ix = new Integrax(
    token: "seu-token",
    baseUrl: "https://sms.aresfun.com", // padrao
    timeout: 15,                         // padrao: 30s
);
```

SMS
---

[](#sms)

```
// Envio simples (usa shortcode padrao da conta)
$res = $ix->sms->send(["5511999999999", "5521888888888"], "Sua mensagem aqui");

// Com shortcode customizado
$res = $ix->sms->send(["5511999999999"], "Ola!", from: "29094");

// $res["code"] == "SMS_SENT"
// $res["data"][0]["status"] == "SENT_TO_OPERATOR"
// $res["data"][0]["messageId"] == "82816396"
```

### DLR (webhook)

[](#dlr-webhook)

Configure seu webhook para receber o status de entrega:

```
{
    "message_id": "82816396",
    "status": "DELIVRD",
    "number": "5511999999999"
}
```

OTP
---

[](#otp)

Duas chamadas: enviar codigo e verificar.

```
// 1. Envio minimo (usa todos os defaults: 6 digitos numericos, expira em 10min)
$ix->otp->send("5511999999999");

// 1b. Personalizado
$ix->otp->send(
    "5511999999999",
    messageDefault: "Use [code] pra confirmar sua conta", // padrao: "Seu codigo: [code]"
    from: "29094",       // se omitido, usa o padrao da conta
    qtdDigits: 5,        // padrao: 6
    withText: true,      // alfanumerico (padrao: false = so numeros)
    expiresIn: 5,        // minutos (padrao: 10)
);

// 2. Verificar codigo digitado pelo usuario
$res = $ix->otp->verify("1MP5L", "5511999999999");
if ($res["status"] === "verified") {
    echo "Codigo valido!";
}
```

RCS
---

[](#rcs)

### BASIC (so texto)

[](#basic-so-texto)

```
$ix->rcs->send(
    ["5511999999999"],
    "Ola! Mensagem RCS basica.",
    "IntegraX",
    rcsType: "BASIC",
);
```

### RICH (card com midia e botoes)

[](#rich-card-com-midia-e-botoes)

```
$ix->rcs->send(
    ["5511999999999"],
    "Confira nossa oferta!",
    "IntegraX",
    rcsMessage: [
        "card" => [
            "title" => "Black Friday",
            "description" => "Ate 60% OFF em todos os produtos.",
            "media" => [
                "file" => ["url" => "https://exemplo.com/banner.png"],
                "height" => "MEDIUM",
            ],
            "suggestions" => [
                [
                    "type" => "OPEN_URL",
                    "text" => "Ver ofertas",
                    "url" => "https://exemplo.com/ofertas",
                    "postbackData" => "click_ofertas",
                ],
            ],
        ],
    ],
);
```

Creditos
--------

[](#creditos)

```
$saldo = $ix->credits->balance();
print_r($saldo);
```

Consultas
---------

[](#consultas)

### Por CPF

[](#por-cpf)

```
$res = $ix->consult->cpf(["00000000001"], showPhoneValid: true, showRestrictions: true);
```

### Por telefone

[](#por-telefone)

```
$res = $ix->consult->phone(["551199999999"]);
```

### Telefone premium (dados enriquecidos)

[](#telefone-premium-dados-enriquecidos)

```
$res = $ix->consult->phonePremium(["551199999999"]);
```

Números internacionais
----------------------

[](#números-internacionais)

- Para números de outros países, insira `+` na frente do número (ex: `+34992000000`).
- Para envios internacionais, é necessário solicitar a ativação da rota através do suporte.
- Alguns países permitem `from` personalizado. Se permitido, basta informar o `from` no payload.

Tratamento de erros
-------------------

[](#tratamento-de-erros)

```
use Integrax\Integrax;
use Integrax\IntegraxException;

try {
    $ix->sms->send(["551100000000"], "teste");
} catch (IntegraxException $e) {
    echo $e->status;    // HTTP status (ex: 401, 422)
    echo $e->errorCode; // codigo da API (ex: "INVALID_TOKEN")
    print_r($e->body);  // corpo completo da resposta
}
```

Licenca
-------

[](#licenca)

MIT

###  Health Score

20

—

LowBetter than 13% of packages

Maintenance58

Moderate activity, may be stable

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/d440584f53c86762bae4d7e25bc2bfa66dc9d7f49d925f189b6e0d92c9a90dc2?d=identicon)[bergantin](/maintainers/bergantin)

---

Top Contributors

[![Al1st1c](https://avatars.githubusercontent.com/u/60362247?v=4)](https://github.com/Al1st1c "Al1st1c (1 commits)")

### Embed Badge

![Health badge](/badges/integrax-integrax-php/health.svg)

```
[![Health](https://phpackages.com/badges/integrax-integrax-php/health.svg)](https://phpackages.com/packages/integrax-integrax-php)
```

###  Alternatives

[mattketmo/email-checker

Throwaway email detection library

2742.1M5](/packages/mattketmo-email-checker)[ifightcrime/bootstrap-growl

Pretty simple jQuery plugin that turns standard Bootstrap alerts into 'Growl-like' notifications.

80113.0k](/packages/ifightcrime-bootstrap-growl)[sarfraznawaz2005/noty

Laravel package to incorporate noty flash notifications into laravel.

324.5k](/packages/sarfraznawaz2005-noty)[andheiberg/notify

A site notification package for laravel.

119.1k1](/packages/andheiberg-notify)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)