Nusa SMS Laravel Service

The service covers all the NusaSMS's API calls endpoint. This service is still in development. Feel free to contribute!

Complete documentation:

https://apidoc.nusasms.com/

Usage

Download or clone this project.
Put this project to your Laravel project directory.

Set the .env as following:

NUSASMS_ENV=development
# or set NUSASMS_ENV to production
NUSASMS_URL=https://api.nusasms.com
NUSASMS_DEV_URL=https://dev.nusasms.com
NUSASMS_API_KEY=<yourApiKey>
NUSASMS_DEV_KEY=DEV_TESTING_API_KEY

What has been covered:

Usage

Get user data using API key:



use \App\Services\NusaSms;

return response()->json(NusaSms::getUser());

Success response example:

{
  "error": false,
  "error_code": 0,
  "message": "APIKey Authentication check",
  "data": {
    "userid": "cdev_testing_user",
    "idPerson": 1000001,
    "idClient": 1000001
  }
}

Get balance data:



use \App\Services\NusaSms;

return response()->json(NusaSms::getBalance());

Success response example:

{
  "error": false,
  "error_code": 0,
  "message": "Client credit data",
  "data": {
    "idClient": 1000001,
    "wa_balance": 1000,
    "wa_expired_date": "2020-01-01",
    "hlr_balance": 0,
    "hlr_expired_date": null,
    "sim_balance": 0,
    "sim_expired_date": null,
    "sms_balance": 782,
    "sms_expired_date": "2020-12-05",
    "pulsa_balance": null
  }
}

WhatsApp Send Media:

There are few notes regarding the usage of this API:

The $request parameter is an instance of \Illuminate\Http\Request. It is made for Laravel.
The file passed to the $request is could be anything, but are limited to 512KB of size.
If there are multiple file passed, the API will simply won't work. So make sure it is ONE file.
The "file" key could be anything.



use \App\Services\NusaSms;

NusaSms::setCaption('Halo');
NusaSms::setSender('6281243214321'); // This is optional, if not set, the NusaSMS's default sender will be used.
NusaSms::setMediaAsBase64($request);

return response()->json(NusaSms::waSendBase64Media('6281212341234'));

Success response example:

{
  "error": false,
  "error_code": 0,
  "message": "WA Send Media",
  "data": {
    "sender": "6281243214321",
    "queue": null,
    "destination": "6281212341234",
    "caption": "Halo",
    "media_url": "https://dev.nusasms.com/assets/Screenshot_20220128_224647.png",
    "ref_no": "933050291643303204"
  }
}

Invalid WA Sender response example:

{
  "error": true,
  "message": "Invalid WA Sender",
  "description": null
}

Invalid destination response example:

{
  "detail": [
    {
      "loc": [
        "body",
        "destination"
      ],
      "msg": "Invalid destination format",
      "type": "value_error"
    },
    {
      "loc": [
        "body",
        "__root__"
      ],
      "msg": "argument of type 'NoneType' is not iterable",
      "type": "type_error"
    }
  ]
}

File exceeds limit of 512KB size

{
  "error": true,
  "message": "File exceed limits (max 512 KB)",
  "description": null
}

WhatsApp Send Media URL:

json(NusaSms::waSendBase64Media('6281212341234'));">



use \App\Services\NusaSms;

NusaSms::setCaption('Halo');
NusaSms::setSender('6281243214321'); // This is optional, if not set, the NusaSMS's default sender will be used.
NusaSms::setUrlMedia("https://upload.wikimedia.org/wikipedia/commons/thumb/9/9f/Flag_of_Indonesia.svg/255px-Flag_of_Indonesia.svg.png");

return response()->json(NusaSms::waSendBase64Media('6281212341234'));

Success response example:

{
  "error": false,
  "error_code": 0,
  "message": "WA Send Media",
  "data": {
    "sender": "6281243214321",
    "queue": null,
    "destination": "6281212341234",
    "caption": "Halo",
    "media_url": "https://upload.wikimedia.org/wikipedia/commons/thumb/9/9f/Flag_of_Indonesia.svg/255px-Flag_of_Indonesia.svg.png",
    "ref_no": "644724881642721371"
  }
}

Invalid WA Sender response example:

{
  "error": true,
  "message": "Invalid WA Sender",
  "description": null
}

Invalid destination response example:

{
  "detail": [
    {
      "loc": [
        "body",
        "destination"
      ],
      "msg": "Invalid destination format",
      "type": "value_error"
    },
    {
      "loc": [
        "body",
        "__root__"
      ],
      "msg": "argument of type 'NoneType' is not iterable",
      "type": "type_error"
    }
  ]
}

File exceeds limit of 512KB size

{
  "error": true,
  "message": "File exceed limits (max 512 KB)",
  "description": null
}

WhatsApp Send Message:

json(NusaSms::waSendMessage('6281212341234'));">



use \App\Services\NusaSms;

NusaSms::setMessage("Hello, world!");
NusaSms::setSender('6281243214321'); // This is optional, if not set, the NusaSMS's default sender will be used.

return response()->json(NusaSms::waSendMessage('6281212341234'));

Success response example:

{
  "error": false,
  "error_code": 0,
  "message": "WA send message",
  "data": {
    "sender": "6281243214321",
    "queue": null,
    "destination": "6281212341234",
    "message": "Hello, world!",
    "ref_no": "008078391643125660"
  }
}

WhatsApp Message Info:



use \App\Services\NusaSms;

return response()->json(NusaSms::waGetMessageInfo("78391643125660"));

Success response example:

{
  "error": false,
  "error_code": 0,
  "message": "Message data",
  "data": {
    "destination": "6281212341234",
    "sender": "6281243214321",
    "is_group": false,
    "create_date": "2022-01-28T23:31:50",
    "sent_date": "2022-01-28T23:31:51",
    "read_date": null,
    "delivered_date": "2022-01-28T23:31:52",
    "ref_no": "008078391643125660",
    "status": "D",
    "message": "Hello, world!",
    "caption": null,
    "media_url": null
  }
}

📲 SmsOffice.ge service with notification channel for Laravel

Laravel SmsOffice This package allows you to send SMS messages with SmsOffice.ge API You can send sms with notification class or directly with SmsOffi

11 Dec 24, 2022

Service manager for Slim compatible with Laravel packages

SlimServices SlimServices is a service manager for the Slim PHP microframework based on Laravel 4 service providers and DI container, allowing you to

76 Jul 23, 2022

Generate and autoload custom Helpers, Builder Scope, Service class, Trait

laravel-make-extender Generate and autoload custom helpers, It can generate multilevel helpers in the context of the directory. Generate Service class

30 Dec 24, 2022

Adds a service worker to Magento2 to enable PWA features

Monsoon PWA Adds icons, a web manifest file and a service-worker file to make magento 2 a PWA. Main Features Supports Magento Blank and Luma as well a

20 Nov 17, 2022

A simple artisanal command framework for creating service layer classes

Introdução Este projeto tem como objetivo fornecer alguns comandos adicionais à interface de linha de comando do Laravel para manipular a estrutura da

15 Feb 2, 2022

PHP client library for reCAPTCHA, a free service to protect your website from spam and abuse.

reCAPTCHA PHP client library reCAPTCHA is a free CAPTCHA service that protects websites from spam and abuse. This is a PHP library that wraps up the s

3.3k Dec 23, 2022

Email validation service in PHP

Email validation service Email validation service in PHP using Laravel 8. Validation features Domain Regular Expression Smtp Txt records Installing de

1 Oct 30, 2021

Ebansos (Electronic Social Assistance) is a web application that provides citizen data management who will receive social assistance to avoid misdirection assistance from public service/government.

E Bansos Ebansos (Electronic Social Assistance) is a web application that provides citizen data management who will receive social assistance to avoid

12 Oct 12, 2022

A bring-your-own-email-first newsletter service. ✨

Typewrite Typewrite a hosted bring-your-own-email newsletter service for people who need a simplistic and privacy-first newsletter service. The core a