direct7-go-sdk

README

Direct7 Go SDK

Go SDK to seamlessly incorporate communication features into your Go applications via the Direct7 REST API. This SDK empowers you to effortlessly initiate SMS,Whatsapp, Slack, Viber messages and 2 factor authentication features.

Documentation

The documentation for the Direct7 REST API can be found here Direct7 API Reference.

Installation

Make sure your project is using Go Modules (it will have a go.mod file in its root if it already is):

go mod init

Then, reference direct7-go-sdk in a Go program with import:

import (
	"github.com/d7networks/direct7-go-sdk/direct7"
    )   

Run any of the normal go commands (build/install/test). The Go toolchain will resolve and fetch the direct7-go module automatically.

Alternatively, you can also explicitly go get the package into a project:

go get -u github.com/d7networks/direct7-go-sdk

Usage

To get started you need to have an active Direct7 account, If you haven't yet registered, please proceed to Sign up

Authentication

In order to initiate API requests, create a client object using your Direct7 API token. To obtain an API token, kindly visit the following link: https://app.d7networks.com/api-tokens.

Examples

• SMS
• Verify
• Whatsapp
• Number Lookup
• Viber
• Slack

SMS

Send SMS

    import (
	"github.com/d7networks/direct7-go-sdk/direct7"
    )

	apiToken := "Your Api Token"
	client := direct7.NewClient(apiToken)
    sms := direct7.NewSMS(client)
	params := direct7.Message{
		Recipients:  []string{"+919999XXXXXX"},
		Content:     "Greetings from D7 API",
		Unicode:     "false",
	}
    response, err := sms.SendMessages([]direct7.Message{params}, "Sender", "https://the_url_to_receive_delivery_report.com", "2024-02-05T09:48:42+0000")

Send an Unicode SMS

    import (
	"github.com/d7networks/direct7-go-sdk/direct7"
    )
	apiToken := "Your Api Token"
	client := direct7.NewClient(apiToken)
    sms := direct7.NewSMS(client)
	params := Message{
		Recipients:  []string{"+919999XXXXXX"},
		Content:     "مرحبا بالعالم!",
		Unicode:     "true",
	}
    response, err := sms.SendMessages([]Message{params}, "Sender", "https://the_url_to_receive_delivery_report.com", "2024-02-05T09:48:42+0000")

Check SMS Request Status

    import (
	"github.com/d7networks/direct7-go-sdk/direct7"
    )   
    apiToken := "Your Api Token"
    client := direct7.NewClient(apiToken)
    sms := direct7.NewSMS(client)
    requestID := "001ff613-de30-4f82-81f6-1fe944b8f61b"
    statusResponse, err := sms.GetStatus(requestID)

Verify

Send OTP

import (
	"github.com/d7networks/direct7-go-sdk/direct7"
    )   
apiToken := "Your Api Token"
client := direct7.NewClient(apiToken)
verify := direct7.NewVerify(client)
originator := "SignOTP"
recipient := "+919999XXXXXX"
content := "Greetings from D7 API, your mobile verification code is: {}"
dataCoding := "text"
expiry := 600
response, err := verify.SendOTP(originator, recipient, content, dataCoding, expiry)

Re-Send OTP

import (
	"github.com/d7networks/direct7-go-sdk/direct7"
    )   
apiToken := "Your Api Token"
client := direct7.NewClient(apiToken)
verify := direct7.NewVerify(client)
otpID := "aeffa23f-1204-4e17-bb91-adf6de2cf826"
response, err := verify.ResendOTP(otpID)

Verify OTP

import (
	"github.com/d7networks/direct7-go-sdk/direct7"
    )   
apiToken := "Your Api Token"
client := direct7.NewClient(apiToken)
verify := direct7.NewVerify(client)
otpID := "32549451-0eb6-4788-8e91-32b2eb9c4260"
otpCode := "803053"
response, err := verify.VerifyOTP(otpID, otpCode)

Check Verify Request Status

    import (
	"github.com/d7networks/direct7-go-sdk/direct7"
    )   
    apiToken := "Your Api Token"
    client := direct7.NewClient(apiToken)
    verify := direct7.NewVerify(client)
    requestID := "001ff613-de30-4f82-81f6-1fe944b8f61b"
    statusResponse, err := verify.GetStatus(requestID)

Whatsapp

Send Whatsapp Free-form Message (Text message)

import (
	"github.com/d7networks/direct7-go-sdk/direct7"
    )   
apiToken := "Your Api Token"
client := direct7.NewClient(apiToken)
originator := "{registered_phonenumber}"
recipient := "{recipient}"
messageType := "TEXT"
optParams := &OptionalParams{
    body: "Hi",
}
response, err := whatsapp.SendWhatsAppFreeformMessage(originator, recipient, messageType, optParams)

Send Whatsapp Templated Message.

import (
	"github.com/d7networks/direct7-go-sdk/direct7"
    )   
apiToken := "Your Api Token"
client := direct7.NewClient(apiToken)
whatsapp := direct7.NewWhatsApp(client)
originator := "{{originator}}"
recipient := "{{recipient}}"
templateId := "with_personalize"
language := "en"
optParams := &OptionalParams{bodyParameterValues: map[string]interface{}{
            "0": "Anu",
}}

response, err := client.whatsapp.SendWhatsAppTemplatedMessage(originator, recipient, templateId, language, optParams)

Send Whatsapp Interactive Message.

import (
	"github.com/d7networks/direct7-go-sdk/direct7"
    )   
apiToken := "Your Api Token"
client := direct7.NewClient(apiToken)
whatsapp := direct7.NewWhatsApp(client)
originator := "{registered_phonenumber}"
recipient := "{recipient}"
interactiveType := "cta_url"
parameters := map[string]interface{}{
        "display_text": "Visit Us",
    "url": "https://www.luckyshrub.com?clickID=kqDGWd24Q5TRwoEQTICY7W1JKoXvaZOXWAS7h1P76s0R7Paec4",
    }
optParams := &OptionalParams{
    headerType: "text",
    headerText: "Payment$ for D7 Whatsapp Service",
    bodyText: "Direct7 Networks is a messaging service provider that specializes in helping organizations efficiently communicate with their customers.",
    footerText: "Thank You",
    parameters: parameters,
}
response, err := client.whatsapp.SendWhatsAppInteractiveMessage(originator, recipient, interactiveType, optParams)

Check Whatsapp Request Status

import (
	"github.com/d7networks/direct7-go-sdk/direct7"
    )   
apiToken := "Your Api Token"
client := direct7.NewClient(apiToken)
whatsapp := direct7.NewWhatsApp(client)
requestID := "001ff613-de30-4f82-81f6-1fe944b8f61b"
statusResponse, err := whatsapp.GetStatus(requestID)

Number Lookup

Search Phone Number Details

import (
	"github.com/d7networks/direct7-go-sdk/direct7"
    )   
apiToken := "Your Api Token"
client := direct7.NewClient(apiToken)
numberLookup := direct7.NewNumberLookup(client)
recipient := "+919999XXXXXX"
response, err := numberLookup.SearchNumberDetails(recipient)

Viber

Send Viber Message

import (
	"github.com/d7networks/direct7-go-sdk/direct7"
    )   
apiToken := "Your Api Token"
client := direct7.NewClient(apiToken)
viber := direct7.NewViber(client)
recipients := []string{"+919999XXXXXX"}
content := "Test Viber message"
label := "PROMOTION"
originator := "INFO2WAY"
callBackURL := "https://example.com/callback"

response, err := viber.SendViberMessage(recipients, content, label, originator, callBackURL)

Check Viber Request Status

import (
	"github.com/d7networks/direct7-go-sdk/direct7"
    )   
apiToken := "Your Api Token"
client := direct7.NewClient(apiToken)
viber := direct7.NewViber(client)
requestID := "001ff613-de30-4f82-81f6-1fe944b8f61b"
statusResponse, err := viber.GetStatus(requestID)

Slack

Send Slack Message

import (
	"github.com/d7networks/direct7-go-sdk/direct7"
    )   
apiToken := "Your Api Token"
client := direct7.NewClient(apiToken)
slack := direct7.NewSlack(client)
content := "Test message content"
workSpaceName := "D7-dev"
channelName := "random"
reportURL := "https://example.com/report"

response, err := slack.SendSlackMessage(content, workSpaceName, channelName, reportURL)

Check Slack Request Status

    import (
	"github.com/d7networks/direct7-go-sdk/direct7"
    )   
    apiToken := "Your Api Token"
    client := direct7.NewClient(apiToken)
    slack := direct7.NewSlack(client)
    requestID := "001ff613-de30-4f82-81f6-1fe944b8f61b"
    statusResponse, err := slack.GetStatus(requestID)

FAQ

How do I get my API token?

You can get your API token from the Direct7 dashboard. If you don't have an account yet, you can create one for free.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Supported Go versions

The SDK supports go 1.18 and higher.

Supported APIs

As of now, the SDK supports the following APIs:

API	Supported?
SMS API	✅
Verify API	✅
Whatsapp API	✅
Number Lookup API	✅
Viber API	✅
Slack API	✅

How do I get started?

You can find the platform documentation @ Direct7 Docs.

How do I get help?

If you need help using the SDK, you can create an issue on GitHub or email to support@d7networks.com

Contributing

We welcome contributions to the Direct7 Go SDK. If you have any ideas for improvements or bug fixes, please feel free to create an issue on GitHub.