Enviar WhatsApp com Ruby: exemplo de API REST (Net::HTTP e Rails)

cURL

curl -X POST https://api.zapzapapi.com/api/v1/SEU_INSTANCE_ID/send/text \
  -H "Content-Type: application/json" \
  -H "x-api-key: SUA_API_KEY" \
  -H "x-api-secret: SEU_API_SECRET" \
  -d '{"number":"5511999999999","text":"Olá! Teste de envio pela API."}'

Ruby

require "net/http"
require "json"

class ZapZap
  class Erro < StandardError
    attr_reader :status, :corpo
    def initialize(status, corpo)
      @status, @corpo = status, corpo
      super("ZapZap #{status}: #{corpo}")
    end
  end

  def initialize(instancia: ENV.fetch("ZAPZAP_INSTANCE_ID"),
                 key: ENV.fetch("ZAPZAP_API_KEY"),
                 secret: ENV.fetch("ZAPZAP_API_SECRET"))
    @base = "https://api.zapzapapi.com/api/v1/#{instancia}"
    @headers = { "Content-Type" => "application/json",
                 "x-api-key" => key, "x-api-secret" => secret }
  end

  def enviar_texto(numero, texto)
    post("/send/text", number: numero, text: texto)
  end

  def post(caminho, dados)
    uri = URI(@base + caminho)
    http = Net::HTTP.new(uri.host, uri.port)
    http.use_ssl = true
    http.open_timeout = 5
    http.read_timeout = 30
    r = http.post(uri.path, JSON.generate(dados), @headers)
    raise Erro.new(r.code.to_i, r.body) unless r.is_a?(Net::HTTPSuccess)
    JSON.parse(r.body)
  end
end

puts ZapZap.new.enviar_texto("5511999999999", "Olá! Seu pedido saiu para entrega.")

Ruby

class ZapZap
  def enviar_pdf(numero, url, nome, legenda = "")
    post("/send/media", number: numero, type: "document",
                        file: url, docName: nome, text: legenda)
  end
end

Ruby (Rails)

class EnviarWhatsappJob < ApplicationJob
  queue_as :default
  retry_on ZapZap::Erro, Net::OpenTimeout, Net::ReadTimeout,
           wait: :polynomially_longer, attempts: 4

  def perform(numero, texto)
    ZapZap.new.enviar_texto(numero, texto)
  rescue ZapZap::Erro => e
    raise if e.status == 429 || e.status >= 500 # o retry_on repete
    Rails.logger.error(e.message)               # 4xx: repetir não resolve, só registra
  end
end

# Uso: EnviarWhatsappJob.perform_later("5511999999999", "Seu pedido foi enviado.")

Ruby (Sinatra)

require "sinatra"
require "json"

post "/webhooks/zapzap" do
  evento = JSON.parse(request.body.read)
  msg = evento.dig("data", "message")
  if evento["event"] == "messages" && msg && !msg["fromMe"]
    Thread.new { puts "mensagem de #{msg["chatid"]}: #{msg["text"]}" }
  end
  status 200
end