integrax 1.0.0__tar.gz

integrax-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 IntegraX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

integrax-1.0.0/PKG-INFO

@@ -0,0 +1,221 @@
+Metadata-Version: 2.4
+Name: integrax
+Version: 1.0.0
+Summary: Send SMS, RCS & OTP messages via API. Bulk SMS, OTP verification, phone number lookup.
+Author-email: Integrax <contato@integrax.lat>
+License-Expression: MIT
+Project-URL: Homepage, https://integrax.lat
+Project-URL: Documentation, https://integrax.lat/desenvolvedores
+Project-URL: Repository, https://github.com/integrax-lat/integrax-python
+Project-URL: Create Account, https://integrax.app
+Keywords: sms,send-sms,bulk-sms,sms-api,rcs,otp,otp-verification,verify-phone,phone-verification,messaging,cpaas,text-message,integrax,api
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Classifier: Topic :: Communications
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.25.0
+Dynamic: license-file
+
+# integrax
+
+SDK oficial da Integrax para Python — SMS, RCS, OTP e consultas via API REST.
+
+- Usa [httpx](https://www.python-httpx.org/) como HTTP client
+- Type hints completos (PEP 561 — `py.typed`)
+- Python 3.9+
+
+## 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.
+
+## Instalação
+
+```bash
+pip install integrax
+```
+
+## Quick start
+
+```python
+from integrax import Integrax
+
+ix = Integrax("seu-token-aqui")
+
+# Enviar SMS
+res = ix.sms.send(["5511999999999"], "Pedido #4821 confirmado ✓")
+print(res["data"][0]["messageId"])  # "82816396"
+```
+
+Ou com context manager:
+
+```python
+with Integrax("seu-token") as ix:
+    ix.sms.send(["5511999999999"], "Olá!")
+```
+
+## Configuração
+
+```python
+ix = Integrax(
+    "seu-token",
+    base_url="https://sms.aresfun.com",  # padrão
+    timeout=15.0,                         # padrão: 30s
+)
+```
+
+## SMS
+
+```python
+# Envio simples (usa shortcode padrão da conta)
+res = ix.sms.send(["5511999999999", "5521888888888"], "Sua mensagem aqui")
+
+# Com shortcode customizado
+res = ix.sms.send(["5511999999999"], "Olá!", from_="29094")
+
+# res["code"] == "SMS_SENT"
+# res["data"][0]["status"] == "SENT_TO_OPERATOR"
+# res["data"][0]["messageId"] == "82816396"
+```
+
+### DLR (webhook)
+
+Configure seu webhook para receber o status de entrega:
+
+```python
+# Payload recebido no seu endpoint
+{
+    "message_id": "82816396",
+    "status": "DELIVRD",  # DELIVRD | EXPIRED | REJECTD | UNDELIV
+    "number": "5511999999999"
+}
+```
+
+## OTP
+
+Duas chamadas: enviar código e verificar.
+
+```python
+# 1. Envio mínimo (usa todos os defaults: 6 dígitos numéricos, expira em 10min)
+ix.otp.send("5511999999999")
+
+# 1b. Personalizado
+ix.otp.send(
+    "5511999999999",
+    message_default="Use [code] pra confirmar sua conta",  # padrão: "Seu código: [code]"
+    from_="29094",       # se omitido, usa o padrão da conta
+    qtd_digits=5,        # padrão: 6
+    with_text=True,      # alfanumérico (padrão: False = só números)
+    expires_in=5,        # minutos (padrão: 10)
+)
+
+# 2. Verificar código digitado pelo usuário
+res = ix.otp.verify("1MP5L", "5511999999999")
+if res["status"] == "verified":
+    print("Código válido!")
+```
+
+## RCS
+
+### BASIC (só texto)
+
+```python
+ix.rcs.send(
+    ["5511999999999"],
+    "Olá! Mensagem RCS básica.",
+    "IntegraX",
+    rcs_type="BASIC",
+)
+```
+
+### RICH (card com mídia e botões)
+
+```python
+ix.rcs.send(
+    ["5511999999999"],
+    "Confira nossa oferta!",
+    "IntegraX",
+    rcs_message={
+        "card": {
+            "title": "Black Friday",
+            "description": "Até 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",
+                }
+            ],
+        }
+    },
+)
+```
+
+## Créditos
+
+```python
+balance = ix.credits.balance()
+print(balance)
+```
+
+## Consultas
+
+### Por CPF
+
+```python
+res = ix.consult.cpf(["00000000001"], show_phone_valid=True, show_restrictions=True)
+```
+
+### Por telefone
+
+```python
+res = ix.consult.phone(["551199999999"])
+```
+
+### Telefone premium (dados enriquecidos)
+
+```python
+res = ix.consult.phone_premium(["551199999999"])
+```
+
+## 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
+
+```python
+from integrax import Integrax, IntegraxError
+
+try:
+    ix.sms.send(["551100000000"], "teste")
+except IntegraxError as e:
+    print(e.status)  # HTTP status (ex: 401, 422)
+    print(e.code)    # código da API
+    print(e.body)    # corpo completo da resposta
+```
+
+## Licença
+
+MIT

integrax-1.0.0/README.md

@@ -0,0 +1,193 @@
+# integrax
+
+SDK oficial da Integrax para Python — SMS, RCS, OTP e consultas via API REST.
+
+- Usa [httpx](https://www.python-httpx.org/) como HTTP client
+- Type hints completos (PEP 561 — `py.typed`)
+- Python 3.9+
+
+## 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.
+
+## Instalação
+
+```bash
+pip install integrax
+```
+
+## Quick start
+
+```python
+from integrax import Integrax
+
+ix = Integrax("seu-token-aqui")
+
+# Enviar SMS
+res = ix.sms.send(["5511999999999"], "Pedido #4821 confirmado ✓")
+print(res["data"][0]["messageId"])  # "82816396"
+```
+
+Ou com context manager:
+
+```python
+with Integrax("seu-token") as ix:
+    ix.sms.send(["5511999999999"], "Olá!")
+```
+
+## Configuração
+
+```python
+ix = Integrax(
+    "seu-token",
+    base_url="https://sms.aresfun.com",  # padrão
+    timeout=15.0,                         # padrão: 30s
+)
+```
+
+## SMS
+
+```python
+# Envio simples (usa shortcode padrão da conta)
+res = ix.sms.send(["5511999999999", "5521888888888"], "Sua mensagem aqui")
+
+# Com shortcode customizado
+res = ix.sms.send(["5511999999999"], "Olá!", from_="29094")
+
+# res["code"] == "SMS_SENT"
+# res["data"][0]["status"] == "SENT_TO_OPERATOR"
+# res["data"][0]["messageId"] == "82816396"
+```
+
+### DLR (webhook)
+
+Configure seu webhook para receber o status de entrega:
+
+```python
+# Payload recebido no seu endpoint
+{
+    "message_id": "82816396",
+    "status": "DELIVRD",  # DELIVRD | EXPIRED | REJECTD | UNDELIV
+    "number": "5511999999999"
+}
+```
+
+## OTP
+
+Duas chamadas: enviar código e verificar.
+
+```python
+# 1. Envio mínimo (usa todos os defaults: 6 dígitos numéricos, expira em 10min)
+ix.otp.send("5511999999999")
+
+# 1b. Personalizado
+ix.otp.send(
+    "5511999999999",
+    message_default="Use [code] pra confirmar sua conta",  # padrão: "Seu código: [code]"
+    from_="29094",       # se omitido, usa o padrão da conta
+    qtd_digits=5,        # padrão: 6
+    with_text=True,      # alfanumérico (padrão: False = só números)
+    expires_in=5,        # minutos (padrão: 10)
+)
+
+# 2. Verificar código digitado pelo usuário
+res = ix.otp.verify("1MP5L", "5511999999999")
+if res["status"] == "verified":
+    print("Código válido!")
+```
+
+## RCS
+
+### BASIC (só texto)
+
+```python
+ix.rcs.send(
+    ["5511999999999"],
+    "Olá! Mensagem RCS básica.",
+    "IntegraX",
+    rcs_type="BASIC",
+)
+```
+
+### RICH (card com mídia e botões)
+
+```python
+ix.rcs.send(
+    ["5511999999999"],
+    "Confira nossa oferta!",
+    "IntegraX",
+    rcs_message={
+        "card": {
+            "title": "Black Friday",
+            "description": "Até 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",
+                }
+            ],
+        }
+    },
+)
+```
+
+## Créditos
+
+```python
+balance = ix.credits.balance()
+print(balance)
+```
+
+## Consultas
+
+### Por CPF
+
+```python
+res = ix.consult.cpf(["00000000001"], show_phone_valid=True, show_restrictions=True)
+```
+
+### Por telefone
+
+```python
+res = ix.consult.phone(["551199999999"])
+```
+
+### Telefone premium (dados enriquecidos)
+
+```python
+res = ix.consult.phone_premium(["551199999999"])
+```
+
+## 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
+
+```python
+from integrax import Integrax, IntegraxError
+
+try:
+    ix.sms.send(["551100000000"], "teste")
+except IntegraxError as e:
+    print(e.status)  # HTTP status (ex: 401, 422)
+    print(e.code)    # código da API
+    print(e.body)    # corpo completo da resposta
+```
+
+## Licença
+
+MIT

integrax-1.0.0/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "integrax"
+version = "1.0.0"
+description = "Send SMS, RCS & OTP messages via API. Bulk SMS, OTP verification, phone number lookup."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [{ name = "Integrax", email = "contato@integrax.lat" }]
+keywords = [
+    "sms",
+    "send-sms",
+    "bulk-sms",
+    "sms-api",
+    "rcs",
+    "otp",
+    "otp-verification",
+    "verify-phone",
+    "phone-verification",
+    "messaging",
+    "cpaas",
+    "text-message",
+    "integrax",
+    "api",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+"Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Typing :: Typed",
+    "Topic :: Communications",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = ["httpx>=0.25.0"]
+
+[project.urls]
+Homepage = "https://integrax.lat"
+Documentation = "https://integrax.lat/desenvolvedores"
+Repository = "https://github.com/integrax-lat/integrax-python"
+"Create Account" = "https://integrax.app"
+
+[tool.setuptools.packages.find]
+where = ["src"]

integrax-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

integrax-1.0.0/src/integrax/__init__.py

@@ -0,0 +1,6 @@
+"""SDK oficial da Integrax — SMS, RCS, OTP e consultas via API REST."""
+
+from .client import Integrax, IntegraxError
+
+__all__ = ["Integrax", "IntegraxError"]
+__version__ = "1.0.0"

integrax-1.0.0/src/integrax/client.py

@@ -0,0 +1,106 @@
+"""Cliente HTTP e classe principal do SDK."""
+
+from __future__ import annotations
+
+from typing import Any
+
+import httpx
+
+from .sms import Sms
+from .otp import Otp
+from .rcs import Rcs
+from .credits import Credits
+from .consult import Consult
+
+
+class IntegraxError(Exception):
+    """Erro retornado pela API da Integrax."""
+
+    def __init__(self, status: int, message: str, code: str | None = None, body: Any = None):
+        super().__init__(message)
+        self.status = status
+        self.code = code
+        self.body = body
+
+
+class HttpClient:
+    """Cliente HTTP interno — não usar diretamente."""
+
+    def __init__(self, token: str, base_url: str, timeout: float):
+        self._token = token
+        self._base_url = base_url.rstrip("/")
+        self._client = httpx.Client(
+            timeout=timeout,
+            headers={"Content-Type": "application/json", "Accept": "application/json"},
+        )
+
+    def _url(self, path: str) -> str:
+        return f"{self._base_url}/v1/integration/{self._token}{path}"
+
+    def _handle(self, res: httpx.Response) -> Any:
+        try:
+            data = res.json()
+        except Exception:
+            data = None
+
+        if not res.is_success:
+            raise IntegraxError(
+                status=res.status_code,
+                message=data.get("message", f"HTTP {res.status_code}") if isinstance(data, dict) else f"HTTP {res.status_code}",
+                code=data.get("code") if isinstance(data, dict) else None,
+                body=data,
+            )
+        return data
+
+    def get(self, path: str) -> Any:
+        return self._handle(self._client.get(self._url(path)))
+
+    def post(self, path: str, body: dict[str, Any] | None = None) -> Any:
+        return self._handle(self._client.post(self._url(path), json=body))
+
+    def close(self) -> None:
+        self._client.close()
+
+
+class Integrax:
+    """
+    SDK da Integrax.
+
+    Args:
+        token: Token de integração.
+        base_url: URL base da API (padrão: https://sms.aresfun.com).
+        timeout: Timeout em segundos (padrão: 30).
+
+    Exemplo::
+
+        ix = Integrax("seu-token-aqui")
+        res = ix.sms.send(["5511999999999"], "Pedido confirmado ✓")
+    """
+
+    def __init__(
+        self,
+        token: str,
+        *,
+        base_url: str = "https://sms.aresfun.com",
+        timeout: float = 30.0,
+    ):
+        if not token:
+            raise ValueError("Integrax: token é obrigatório")
+
+        self._http = HttpClient(token, base_url, timeout)
+
+        self.sms = Sms(self._http)
+        self.otp = Otp(self._http)
+        self.rcs = Rcs(self._http)
+        self.credits = Credits(self._http)
+        self.consult = Consult(self._http)
+
+    def close(self) -> None:
+        """Fecha o cliente HTTP."""
+        self._http.close()
+
+    def __enter__(self) -> Integrax:
+        return self
+
+    def __exit__(self, *_: Any) -> None:
+        self.close()

integrax-1.0.0/src/integrax/consult.py

@@ -0,0 +1,65 @@
+"""Recurso Consult."""
+
+from __future__ import annotations
+
+from typing import Any, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .client import HttpClient
+
+
+class Consult:
+    def __init__(self, http: HttpClient):
+        self._http = http
+
+    def cpf(
+        self,
+        documents: list[str],
+        *,
+        show_phone_valid: bool | None = None,
+        show_restrictions: bool | None = None,
+    ) -> dict[str, Any]:
+        """
+        Consulta dados por CPF.
+
+        Args:
+            documents: Lista de CPFs (apenas números).
+            show_phone_valid: Retornar telefones válidos.
+            show_restrictions: Retornar restrições.
+
+        Exemplo::
+
+            res = ix.consult.cpf(["00000000001"], show_phone_valid=True)
+        """
+        body: dict[str, Any] = {"documents": documents, "type": "cpf"}
+        if show_phone_valid is not None:
+            body["showPhoneValid"] = show_phone_valid
+        if show_restrictions is not None:
+            body["showRestrictions"] = show_restrictions
+        return self._http.post("/consult", body)
+
+    def phone(self, phones: list[str]) -> dict[str, Any]:
+        """
+        Consulta dados por número de telefone.
+
+        Args:
+            phones: Lista de telefones.
+
+        Exemplo::
+
+            res = ix.consult.phone(["551199999999"])
+        """
+        return self._http.post("/consult-phone", {"phones": phones})
+
+    def phone_premium(self, phones: list[str]) -> dict[str, Any]:
+        """
+        Consulta premium por número de telefone (dados enriquecidos).
+
+        Args:
+            phones: Lista de telefones.
+
+        Exemplo::
+
+            res = ix.consult.phone_premium(["551199999999"])
+        """
+        return self._http.post("/consult-phone-premium", {"phones": phones})

integrax-1.0.0/src/integrax/credits.py

@@ -0,0 +1,24 @@
+"""Recurso Credits."""
+
+from __future__ import annotations
+
+from typing import Any, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .client import HttpClient
+
+
+class Credits:
+    def __init__(self, http: HttpClient):
+        self._http = http
+
+    def balance(self) -> dict[str, Any]:
+        """
+        Consulta o saldo de créditos da conta.
+
+        Exemplo::
+
+            balance = ix.credits.balance()
+            print(balance)
+        """
+        return self._http.get("/consult/credits")

integrax-1.0.0/src/integrax/otp.py

@@ -0,0 +1,80 @@
+"""Recurso OTP."""
+
+from __future__ import annotations
+
+from typing import Any, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .client import HttpClient
+
+
+class Otp:
+    def __init__(self, http: HttpClient):
+        self._http = http
+
+    def send(
+        self,
+        to: str,
+        *,
+        message_default: str | None = None,
+        from_: str | None = None,
+        qtd_digits: int | None = None,
+        with_text: bool | None = None,
+        expires_in: int | None = None,
+    ) -> dict[str, Any]:
+        """
+        Envia um código OTP via SMS.
+
+        A Integrax gera o código automaticamente e substitui o placeholder [code].
+
+        Args:
+            to: Número destino (ex: "5511999999999").
+            message_default: Mensagem com placeholder [code]. Padrão: "Seu código: [code]".
+            from_: Shortcode de envio. Se omitido, usa o padrão da conta.
+            qtd_digits: Total de caracteres no código (padrão: 6).
+            with_text: True = alfanumérico, False = só números (padrão: False).
+            expires_in: Minutos até expirar o código (padrão: 10).
+
+        Exemplo::
+
+            # Envio mínimo (usa todos os defaults)
+            ix.otp.send("5511999999999")
+
+            # Personalizado
+            ix.otp.send(
+                "5511999999999",
+                message_default="Use [code] pra confirmar",
+                from_="29094",
+                qtd_digits=5,
+                with_text=True,
+                expires_in=5,
+            )
+        """
+        body: dict[str, Any] = {"to": to}
+        if message_default is not None:
+            body["message_default"] = message_default
+        if from_ is not None:
+            body["from"] = from_
+        if qtd_digits is not None:
+            body["qtd_digits"] = qtd_digits
+        if with_text is not None:
+            body["with_text"] = with_text
+        if expires_in is not None:
+            body["expires_in"] = expires_in
+        return self._http.post("/send-otp", body)
+
+    def verify(self, code: str, phone: str) -> dict[str, Any]:
+        """
+        Valida um código OTP digitado pelo usuário.
+
+        Args:
+            code: Código digitado pelo usuário.
+            phone: Número que recebeu o SMS.
+
+        Exemplo::
+
+            res = ix.otp.verify("1MP5L", "5511999999999")
+            if res["status"] == "verified":
+                print("Código válido!")
+        """
+        return self._http.post("/verify-otp", {"code": code, "phone": phone})

integrax-1.0.0/src/integrax/rcs.py

@@ -0,0 +1,74 @@
+"""Recurso RCS."""
+
+from __future__ import annotations
+
+from typing import Any, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .client import HttpClient
+
+
+class Rcs:
+    def __init__(self, http: HttpClient):
+        self._http = http
+
+    def send(
+        self,
+        to: list[str],
+        message: str,
+        from_: str,
+        *,
+        rcs_type: str | None = None,
+        rcs_message: dict[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        """
+        Envia mensagem RCS (BASIC ou RICH com card).
+
+        Args:
+            to: Lista de números destino.
+            message: Texto da mensagem (fallback ou mensagem BASIC).
+            from_: Sender aprovado.
+            rcs_type: "BASIC", "RICH" ou "SINGLE".
+            rcs_message: Card rico com mídia e botões (obrigatório pra RICH).
+
+        Exemplo BASIC::
+
+            ix.rcs.send(
+                ["5511999999999"],
+                "Olá! Mensagem RCS básica.",
+                "IntegraX",
+                rcs_type="BASIC",
+            )
+
+        Exemplo RICH::
+
+            ix.rcs.send(
+                ["5511999999999"],
+                "Confira nossa oferta!",
+                "IntegraX",
+                rcs_message={
+                    "card": {
+                        "title": "Black Friday",
+                        "description": "Até 60% OFF.",
+                        "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",
+                            }
+                        ],
+                    }
+                },
+            )
+        """
+        body: dict[str, Any] = {"to": to, "message": message, "from": from_}
+        if rcs_type is not None:
+            body["rcsType"] = rcs_type
+        if rcs_message is not None:
+            body["rcsMessage"] = rcs_message
+        return self._http.post("/send-rcs", body)

integrax-1.0.0/src/integrax/sms.py

@@ -0,0 +1,41 @@
+"""Recurso SMS."""
+
+from __future__ import annotations
+
+from typing import Any, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .client import HttpClient
+
+
+class Sms:
+    def __init__(self, http: HttpClient):
+        self._http = http
+
+    def send(
+        self,
+        to: list[str],
+        message: str,
+        *,
+        from_: str | None = None,
+    ) -> dict[str, Any]:
+        """
+        Envia SMS pra um ou mais números.
+
+        Args:
+            to: Lista de números destino (ex: ["5511999999999"]).
+            message: Conteúdo da mensagem.
+            from_: Shortcode ou sender ID (ex: "29094"). Se omitido, usa o padrão da conta.
+
+        Exemplo::
+
+            res = ix.sms.send(["5511999999999"], "Pedido confirmado ✓")
+            print(res["data"][0]["messageId"])  # "82816396"
+
+            # Com shortcode customizado
+            res = ix.sms.send(["5511999999999"], "Olá!", from_="29094")
+        """
+        body: dict[str, Any] = {"to": to, "message": message}
+        if from_ is not None:
+            body["from"] = from_
+        return self._http.post("/send-sms", body)

integrax-1.0.0/src/integrax.egg-info/PKG-INFO

@@ -0,0 +1,221 @@
+Metadata-Version: 2.4
+Name: integrax
+Version: 1.0.0
+Summary: Send SMS, RCS & OTP messages via API. Bulk SMS, OTP verification, phone number lookup.
+Author-email: Integrax <contato@integrax.lat>
+License-Expression: MIT
+Project-URL: Homepage, https://integrax.lat
+Project-URL: Documentation, https://integrax.lat/desenvolvedores
+Project-URL: Repository, https://github.com/integrax-lat/integrax-python
+Project-URL: Create Account, https://integrax.app
+Keywords: sms,send-sms,bulk-sms,sms-api,rcs,otp,otp-verification,verify-phone,phone-verification,messaging,cpaas,text-message,integrax,api
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Classifier: Topic :: Communications
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.25.0
+Dynamic: license-file
+
+# integrax
+
+SDK oficial da Integrax para Python — SMS, RCS, OTP e consultas via API REST.
+
+- Usa [httpx](https://www.python-httpx.org/) como HTTP client
+- Type hints completos (PEP 561 — `py.typed`)
+- Python 3.9+
+
+## 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.
+
+## Instalação
+
+```bash
+pip install integrax
+```
+
+## Quick start
+
+```python
+from integrax import Integrax
+
+ix = Integrax("seu-token-aqui")
+
+# Enviar SMS
+res = ix.sms.send(["5511999999999"], "Pedido #4821 confirmado ✓")
+print(res["data"][0]["messageId"])  # "82816396"
+```
+
+Ou com context manager:
+
+```python
+with Integrax("seu-token") as ix:
+    ix.sms.send(["5511999999999"], "Olá!")
+```
+
+## Configuração
+
+```python
+ix = Integrax(
+    "seu-token",
+    base_url="https://sms.aresfun.com",  # padrão
+    timeout=15.0,                         # padrão: 30s
+)
+```
+
+## SMS
+
+```python
+# Envio simples (usa shortcode padrão da conta)
+res = ix.sms.send(["5511999999999", "5521888888888"], "Sua mensagem aqui")
+
+# Com shortcode customizado
+res = ix.sms.send(["5511999999999"], "Olá!", from_="29094")
+
+# res["code"] == "SMS_SENT"
+# res["data"][0]["status"] == "SENT_TO_OPERATOR"
+# res["data"][0]["messageId"] == "82816396"
+```
+
+### DLR (webhook)
+
+Configure seu webhook para receber o status de entrega:
+
+```python
+# Payload recebido no seu endpoint
+{
+    "message_id": "82816396",
+    "status": "DELIVRD",  # DELIVRD | EXPIRED | REJECTD | UNDELIV
+    "number": "5511999999999"
+}
+```
+
+## OTP
+
+Duas chamadas: enviar código e verificar.
+
+```python
+# 1. Envio mínimo (usa todos os defaults: 6 dígitos numéricos, expira em 10min)
+ix.otp.send("5511999999999")
+
+# 1b. Personalizado
+ix.otp.send(
+    "5511999999999",
+    message_default="Use [code] pra confirmar sua conta",  # padrão: "Seu código: [code]"
+    from_="29094",       # se omitido, usa o padrão da conta
+    qtd_digits=5,        # padrão: 6
+    with_text=True,      # alfanumérico (padrão: False = só números)
+    expires_in=5,        # minutos (padrão: 10)
+)
+
+# 2. Verificar código digitado pelo usuário
+res = ix.otp.verify("1MP5L", "5511999999999")
+if res["status"] == "verified":
+    print("Código válido!")
+```
+
+## RCS
+
+### BASIC (só texto)
+
+```python
+ix.rcs.send(
+    ["5511999999999"],
+    "Olá! Mensagem RCS básica.",
+    "IntegraX",
+    rcs_type="BASIC",
+)
+```
+
+### RICH (card com mídia e botões)
+
+```python
+ix.rcs.send(
+    ["5511999999999"],
+    "Confira nossa oferta!",
+    "IntegraX",
+    rcs_message={
+        "card": {
+            "title": "Black Friday",
+            "description": "Até 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",
+                }
+            ],
+        }
+    },
+)
+```
+
+## Créditos
+
+```python
+balance = ix.credits.balance()
+print(balance)
+```
+
+## Consultas
+
+### Por CPF
+
+```python
+res = ix.consult.cpf(["00000000001"], show_phone_valid=True, show_restrictions=True)
+```
+
+### Por telefone
+
+```python
+res = ix.consult.phone(["551199999999"])
+```
+
+### Telefone premium (dados enriquecidos)
+
+```python
+res = ix.consult.phone_premium(["551199999999"])
+```
+
+## 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
+
+```python
+from integrax import Integrax, IntegraxError
+
+try:
+    ix.sms.send(["551100000000"], "teste")
+except IntegraxError as e:
+    print(e.status)  # HTTP status (ex: 401, 422)
+    print(e.code)    # código da API
+    print(e.body)    # corpo completo da resposta
+```
+
+## Licença
+
+MIT

integrax-1.0.0/src/integrax.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+src/integrax/__init__.py
+src/integrax/client.py
+src/integrax/consult.py
+src/integrax/credits.py
+src/integrax/otp.py
+src/integrax/py.typed
+src/integrax/rcs.py
+src/integrax/sms.py
+src/integrax.egg-info/PKG-INFO
+src/integrax.egg-info/SOURCES.txt
+src/integrax.egg-info/dependency_links.txt
+src/integrax.egg-info/requires.txt
+src/integrax.egg-info/top_level.txt

integrax-1.0.0/src/integrax.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

integrax-1.0.0/src/integrax.egg-info/requires.txt

@@ -0,0 +1 @@
+httpx>=0.25.0

integrax-1.0.0/src/integrax.egg-info/top_level.txt

@@ -0,0 +1 @@
+integrax