SDK Go

go get github.com/ararahq/arara-go-sdk@v1.0.0

import (
    "log"
    "os"
    "time"

    arara "github.com/ararahq/arara-go-sdk"
)

client, err := arara.NewClient(
    os.Getenv("ARARA_API_KEY"),
    arara.WithBaseURL("https://api.ararahq.com"), // opcional, este é o default
    arara.WithTimeout(15*time.Second),            // opcional, default 10s
    arara.WithMaxRetries(3),                      // opcional, default 3
)
if err != nil {
    log.Fatal(err) // apiKey vazia (*arara.APIError, code INVALID_CONFIG)
}

package main

import (
    "context"
    "fmt"
    "log"
    "os"

    arara "github.com/ararahq/arara-go-sdk"
)

func main() {
    client, err := arara.NewClient(os.Getenv("ARARA_API_KEY"))
    if err != nil {
        log.Fatal(err)
    }

    orderID := "12345" // id do evento no seu sistema

    resp, err := client.Messages.Send(context.Background(), &arara.SendMessageRequest{
        Receiver:          "whatsapp:+5511999999999",
        TemplateName:      "pedido_confirmado",
        TemplateVariables: []string{"João", orderID},
    }, arara.SendOptions{IdempotencyKey: "hello-" + orderID})
    if err != nil {
        log.Fatal(err)
    }

    if resp.ID != nil { // o id vem como *string e pode ser nulo
        fmt.Println(*resp.ID, resp.Status) // ara_msg_... e status inicial
    }
}

go mod init exemplo
go get github.com/ararahq/arara-go-sdk@v1.0.0
ARARA_API_KEY=ara_live_... go run .

_, err = client.Messages.Send(ctx, &arara.SendMessageRequest{
    Receiver:     "whatsapp:+5511999999999",
    TemplateName: "confirmacao_pedido",
    TemplateVariables: []string{
        "https://meusite.com/nota/123.pdf", // header (mídia opcional)
        "João",                              // {{1}}
        "ARA-12345",                         // {{2}}
    },
}, arara.SendOptions{IdempotencyKey: "pedido-12345"})

_, err = client.Messages.Send(ctx, &arara.SendMessageRequest{
    Receiver: "whatsapp:+5511999999999",
    Body:     "Oi! Vi sua dúvida e respondo já já.",
})

tpl, err := client.Templates.Create(ctx, &arara.CreateTemplateRequest{
    Name:     "promo_natal",
    Category: "MARKETING",
    Language: "pt_BR",
    Body:     "Oi {{1}}, oferta de Natal: {{2}}% off até {{3}}.",
    Samples:  map[string]any{"1": "João", "2": "30", "3": "sexta"},
})
if err != nil {
    log.Fatal(err)
}

status, err := client.Templates.GetStatus(ctx, tpl.ID)
if err == nil {
    fmt.Println(status.Status) // PENDING, APPROVED, REJECTED...
}

import "errors"

_, err := client.Messages.Send(ctx, req)
var apiErr *arara.APIError
if errors.As(err, &apiErr) {
    fmt.Println(apiErr.StatusCode, apiErr.Code, apiErr.Message, apiErr.Details)
    if apiErr.StatusCode == 429 && apiErr.RetryAfter != nil {
        fmt.Println("tente de novo em", *apiErr.RetryAfter, "segundos")
    }
}

campaign, err := client.Campaigns.Create(ctx, &arara.CampaignRequest{
    Name:         "blackfriday-2026",
    TemplateName: "bf_oferta_geral",
    Contacts: []arara.CampaignContactRequest{
        {To: "whatsapp:+5511999999999", Variables: []string{"João", "30"}},
        {To: "whatsapp:+5511888888888", Variables: []string{"Maria", "25"}},
    },
}, arara.CampaignCreateOptions{IdempotencyKey: "bf-2026-lote-1"})
if err != nil {
    log.Fatal(err)
}

detail, err := client.Campaigns.Get(ctx, campaign.ID)

const toleranceSeconds = 300

func validSignature(secret, timestamp, signature string, body []byte) bool {
    sent, err := strconv.ParseInt(timestamp, 10, 64)
    if err != nil || math.Abs(float64(time.Now().Unix()-sent)) > toleranceSeconds {
        return false
    }
    mac := hmac.New(sha256.New, []byte(secret))
    mac.Write([]byte(timestamp + "."))
    mac.Write(body)
    expected := "sha256=" + hex.EncodeToString(mac.Sum(nil))
    return hmac.Equal([]byte(expected), []byte(signature))
}

contacts, err := client.Contacts.List(ctx, arara.ContactListParams{Page: 0, Size: 20, Lifecycle: "ENGAGED"})

_, err = client.Conversations.Reply(ctx, &arara.ConversationReplyRequest{
    ConversationID: "3f1e...",
    Body:           "Seu pedido saiu para entrega.",
})