SDK Ruby

# Gemfile
gem "ararahq"

bundle install

require "arara"

client = Arara::Client.new(
  api_key: ENV.fetch("ARARA_API_KEY"),
  base_url: "https://api.ararahq.com", # opcional, este é o default
  timeout: 10,                          # opcional, em segundos (open e read)
  max_retries: 3                        # opcional
)

require "arara"

client = Arara::Client.new(api_key: ENV.fetch("ARARA_API_KEY"))

order_id = "12345" # id do evento no seu sistema

result = client.messages.send_message(
  receiver: "+5511999999999",
  template_name: "pedido_confirmado",
  template_variables: ["João", order_id],
  idempotency_key: "hello-#{order_id}"
)

puts result["id"]     # ara_msg_...
puts result["status"] # PENDING

ARARA_API_KEY=ara_live_... bundle exec ruby enviar.rb

client.messages.send_message(
  receiver: "+5511999999999",
  template_name: "confirmacao_pedido",
  template_variables: [
    "https://meusite.com/nota/123.pdf", # header (mídia opcional)
    "João",                              # {{1}}
    "ARA-12345"                          # {{2}}
  ],
  idempotency_key: "pedido-12345"
)

client.messages.send_message(
  receiver: "+5511999999999",
  body: "Oi! Vi sua dúvida e respondo já já.",
  idempotency_key: "resposta-98765"
)

message = client.messages.get(result["id"])
puts message["status"] # DELIVERED, FAILED...

page = client.templates.list
page.each { |t| puts "#{t["name"]} #{t["providerStatus"]}" }

template = client.templates.create(
  "name" => "promo_natal",
  "category" => "MARKETING",
  "language" => "pt_BR",
  "body" => "Oi {{1}}, oferta de Natal: {{2}}% off até {{3}}.",
  "samples" => { "1" => "João", "2" => "30", "3" => "sexta" }
)

status = client.templates.get_status(template["id"])
puts status["status"]

existing = client.templates.find_by_name("pedido_confirmado") # Hash, ou nil se não existir

begin
  client.messages.send_message(
    receiver: "+5511999999999",
    template_name: "confirmacao_pedido",
    idempotency_key: "pedido-12345"
  )
rescue Arara::RateLimitError => e
  sleep(e.retry_after || 1)
rescue Arara::PaymentRequiredError
  puts "Saldo insuficiente. Recarregue em https://app.ararahq.com."
rescue Arara::UnprocessableEntityError => e
  puts "Telefone ou dados inválidos: #{e.code}"
rescue Arara::Error => e
  puts "#{e.status_code} #{e.code}: #{e.message}"
end

campaign = client.campaigns.create(
  {
    "name" => "blackfriday-2026",
    "templateName" => "bf_oferta_geral",
    "contacts" => [
      { "to" => "+5511999999999", "variables" => ["João", "30"] },
      { "to" => "+5511888888888", "variables" => ["Maria", "25"] }
    ]
  },
  idempotency_key: "bf-2026-lote-1"
)

detail = client.campaigns.get(campaign["id"])

require "openssl"

TOLERANCE_SECONDS = 300

def valid_arara_signature?(raw_body, timestamp, signature, secret)
  return false unless timestamp.is_a?(String) && signature.is_a?(String)
  return false unless timestamp.match?(/\A\d+\z/) && signature.start_with?("sha256=")
  return false if (Time.now.to_i - timestamp.to_i).abs > TOLERANCE_SECONDS

  expected = OpenSSL::HMAC.hexdigest("SHA256", secret, "#{timestamp}.#{raw_body}")
  received = signature.delete_prefix("sha256=")
  expected.bytesize == received.bytesize && OpenSSL.fixed_length_secure_compare(expected, received)
end