# APPLOI_API_KEY must hold the Partner API key you received from Apploi.
# These examples do not set it for you: set it yourself, in your own
# environment, before running them. For example, in your shell:
#   export APPLOI_API_KEY="<the API key you received from Apploi>"

curl -sS -X POST https://partners.apploi.com/applicants/98765432/message \
  -H "X-Api-Key: $APPLOI_API_KEY" \
  -H "Content-Type: application/json" \
  -w "\nHTTP status: %{http_code}\n" \
  -d '{
    "external_id": "msg7f3a90",
    "message_type": "text",
    "message_direction": "to_candidate",
    "message_body": "Hi Jane, thanks for applying. Are you free for a phone screen this week?",
    "status": "DELIVERED",
    "vendor_name": "Acme Messaging",
    "is_sent_by_vendor": true,
    "sender_email": "[email protected]"
  }'

import os

import requests

# APPLOI_API_KEY must hold the Partner API key you received from Apploi.
# These examples do not set it for you: set it yourself, in your own
# environment, before running them. For example, in your shell:
#   export APPLOI_API_KEY="<the API key you received from Apploi>"
API_KEY = os.environ["APPLOI_API_KEY"]

def post_message(job_application_id, message):
    response = requests.post(
        f"https://partners.apploi.com/applicants/{job_application_id}/message",
        headers={"X-Api-Key": API_KEY},
        json=message,
        timeout=30,
    )
    if not response.ok:
        # 400: fix the request before sending it again. 5xx: see "Retrying safely".
        raise RuntimeError(f"Request failed with status {response.status_code}: {response.text}")
    try:
        body = response.json()
    except ValueError:
        # A server error can arrive with status 200 and a body that isn't JSON. See "Retrying safely".
        raise RuntimeError(f"Unexpected response: {response.text[:200]}")
    result = body.get("data")
    if not result or result.get("status") != "success":
        # Some errors arrive with status 200. See "What the response means".
        raise RuntimeError(f"Message not accepted: {body}")
    return result

recorded = post_message(98765432, {
    "external_id": "msg7f3a90",  # your own id, up to 36 characters
    "message_type": "text",
    "message_direction": "to_candidate",
    "message_body": "Hi Jane, thanks for applying. Are you free for a phone screen this week?",
    "status": "DELIVERED",
    "vendor_name": "Acme Messaging",
    "is_sent_by_vendor": True,
    "sender_email": "[email protected]",
})
print(recorded["message"])  # "Message updated successfully"

// APPLOI_API_KEY must hold the Partner API key you received from Apploi.
// These examples do not set it for you: set it yourself, in your own
// environment, before running them. For example, in your shell:
//   export APPLOI_API_KEY="<the API key you received from Apploi>"
if (!process.env.APPLOI_API_KEY) {
  throw new Error("Set APPLOI_API_KEY to the Partner API key you received from Apploi");
}
const API_KEY: string = process.env.APPLOI_API_KEY;

async function postMessage(jobApplicationId: number, message: object): Promise<any> {
  const response = await fetch(
    `https://partners.apploi.com/applicants/${jobApplicationId}/message`,
    {
      method: "POST",
      headers: { "X-Api-Key": API_KEY, "Content-Type": "application/json" },
      body: JSON.stringify(message),
    },
  );
  if (!response.ok) {
    // 400: fix the request before sending it again. 5xx: see "Retrying safely".
    throw new Error(`Request failed with status ${response.status}: ${await response.text()}`);
  }
  const text = await response.text();
  let body: any;
  try {
    body = JSON.parse(text);
  } catch {
    // A server error can arrive with status 200 and a body that isn't JSON. See "Retrying safely".
    throw new Error(`Unexpected response: ${text.slice(0, 200)}`);
  }
  if (body.data?.status !== "success") {
    // Some errors arrive with status 200. See "What the response means".
    throw new Error(`Message not accepted: ${JSON.stringify(body)}`);
  }
  return body.data;
}

const recorded = await postMessage(98765432, {
  external_id: "msg7f3a90", // your own id, up to 36 characters
  message_type: "text",
  message_direction: "to_candidate",
  message_body: "Hi Jane, thanks for applying. Are you free for a phone screen this week?",
  status: "DELIVERED",
  vendor_name: "Acme Messaging",
  is_sent_by_vendor: true,
  sender_email: "[email protected]",
});
console.log(recorded.message); // "Message updated successfully"

require "json"
require "net/http"
require "uri"

# APPLOI_API_KEY must hold the Partner API key you received from Apploi.
# These examples do not set it for you: set it yourself, in your own
# environment, before running them. For example, in your shell:
#   export APPLOI_API_KEY="<the API key you received from Apploi>"
API_KEY = ENV.fetch("APPLOI_API_KEY")

def post_message(job_application_id, message)
  uri = URI("https://partners.apploi.com/applicants/#{job_application_id}/message")
  request = Net::HTTP::Post.new(uri)
  request["X-Api-Key"] = API_KEY
  request["Content-Type"] = "application/json"
  request.body = JSON.generate(message)

  response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true, read_timeout: 30) do |http|
    http.request(request)
  end
  # 400: fix the request before sending it again. 5xx: see "Retrying safely".
  raise "Request failed with status #{response.code}: #{response.body}" unless response.is_a?(Net::HTTPSuccess)

  body = begin
    JSON.parse(response.body)
  rescue JSON::ParserError
    # A server error can arrive with status 200 and a body that isn't JSON. See "Retrying safely".
    raise "Unexpected response: #{response.body[0, 200]}"
  end
  result = body["data"]
  # Some errors arrive with status 200. See "What the response means".
  raise "Message not accepted: #{body}" unless result.is_a?(Hash) && result["status"] == "success"

  result
end

recorded = post_message(98765432, {
  external_id: "msg7f3a90", # your own id, up to 36 characters
  message_type: "text",
  message_direction: "to_candidate",
  message_body: "Hi Jane, thanks for applying. Are you free for a phone screen this week?",
  status: "DELIVERED",
  vendor_name: "Acme Messaging",
  is_sent_by_vendor: true,
  sender_email: "[email protected]"
})
puts recorded["message"] # "Message updated successfully"

# APPLOI_API_KEY must hold the Partner API key you received from Apploi.
# These examples do not set it for you: set it yourself, in your own
# environment, before running them. For example, in your shell:
#   export APPLOI_API_KEY="<the API key you received from Apploi>"

curl -sS -X POST https://partners.apploi.com/applicants/98765432/message \
  -H "X-Api-Key: $APPLOI_API_KEY" \
  -H "Content-Type: application/json" \
  -w "\nHTTP status: %{http_code}\n" \
  -d '{
    "external_id": "msg7f3a91",
    "message_type": "email",
    "message_direction": "to_candidate",
    "subject": "Interview invitation",
    "message_body": "Thanks for applying. Could you come in for an interview on Tuesday at 10am?",
    "status": "QUEUED",
    "vendor_name": "Acme Messaging",
    "is_sent_by_vendor": false,
    "sender_email": "[email protected]"
  }'

sent = post_message(98765432, {
    "external_id": "msg7f3a91",
    "message_type": "email",
    "message_direction": "to_candidate",
    "subject": "Interview invitation",  # required for email
    "message_body": "Thanks for applying. Could you come in for an interview on Tuesday at 10am?",
    "status": "QUEUED",
    "vendor_name": "Acme Messaging",
    "is_sent_by_vendor": False,  # Apploi delivers it
    "sender_email": "[email protected]",
})
print(sent["message"])  # "Message sent successfully"

const sent = await postMessage(98765432, {
  external_id: "msg7f3a91",
  message_type: "email",
  message_direction: "to_candidate",
  subject: "Interview invitation", // required for email
  message_body: "Thanks for applying. Could you come in for an interview on Tuesday at 10am?",
  status: "QUEUED",
  vendor_name: "Acme Messaging",
  is_sent_by_vendor: false, // Apploi delivers it
  sender_email: "[email protected]",
});
console.log(sent.message); // "Message sent successfully"

sent = post_message(98765432, {
  external_id: "msg7f3a91",
  message_type: "email",
  message_direction: "to_candidate",
  subject: "Interview invitation", # required for email
  message_body: "Thanks for applying. Could you come in for an interview on Tuesday at 10am?",
  status: "QUEUED",
  vendor_name: "Acme Messaging",
  is_sent_by_vendor: false, # Apploi delivers it
  sender_email: "[email protected]"
})
puts sent["message"] # "Message sent successfully"

# APPLOI_API_KEY must hold the Partner API key you received from Apploi.
# These examples do not set it for you: set it yourself, in your own
# environment, before running them. For example, in your shell:
#   export APPLOI_API_KEY="<the API key you received from Apploi>"

curl -sS -X POST https://partners.apploi.com/applicants/98765432/message \
  -H "X-Api-Key: $APPLOI_API_KEY" \
  -H "Content-Type: application/json" \
  -w "\nHTTP status: %{http_code}\n" \
  -d '{
    "external_id": "msg7f3a9c",
    "message_type": "text",
    "message_direction": "from_candidate",
    "message_body": "Yes, Tuesday at 10am works for me.",
    "status": "received",
    "vendor_name": "Acme Messaging",
    "sender_email": "[email protected]"
  }'

reply = post_message(98765432, {
    "external_id": "msg7f3a9c",
    "message_type": "text",
    "message_direction": "from_candidate",
    "message_body": "Yes, Tuesday at 10am works for me.",
    "status": "received",
    "vendor_name": "Acme Messaging",
    "sender_email": "[email protected]",  # the recruiter the applicant replied to
})

const reply = await postMessage(98765432, {
  external_id: "msg7f3a9c",
  message_type: "text",
  message_direction: "from_candidate",
  message_body: "Yes, Tuesday at 10am works for me.",
  status: "received",
  vendor_name: "Acme Messaging",
  sender_email: "[email protected]", // the recruiter the applicant replied to
});

reply = post_message(98765432, {
  external_id: "msg7f3a9c",
  message_type: "text",
  message_direction: "from_candidate",
  message_body: "Yes, Tuesday at 10am works for me.",
  status: "received",
  vendor_name: "Acme Messaging",
  sender_email: "[email protected]" # the recruiter the applicant replied to
})

{
  "data": {
    "status": "success",
    "message": "Message updated successfully"
  }
}