{
  "openapi": "3.1.0",
  "info": {
    "title": "Atom Panamá agent inquiry API",
    "version": "1.0.0",
    "description": "Atom Panamá es la marca de Atom Technologies para empresas de América Latina y España: su equipo de desarrollo, para su empresa. Un ingeniero senior que trabaja dentro del equipo del cliente o un equipo dedicado que dirige nuestro líder técnico, los sistemas con los que opera una empresa (facturación electrónica, ERP, agenda, cobros y reportes) y trabajo de datos e IA. En español, desde Ciudad de Panamá, con precios publicados en dólares.\n\nAI agents and assistants can send an inquiry on behalf of a person here. An automated system answers with a machine-readable acknowledgement and the booking link; a person on the Atom Panamá team reads every inquiry and answers the contact directly. Nothing is emailed to the contact automatically. Send only what the person agreed to share, and set consent to true only if they agreed to be contacted.\n\nPrivacy: Atom Digital Technologies LLP (Inglaterra y Gales, OC450214), Torre de las Américas, piso 12, oficina 1203, Ciudad de Panamá, que opera Atom Panamá es responsable de la información que un agente envía aquí. Se usa para responder esta consulta, darle seguimiento y contar las consultas, según Ley 81 de 2019 de Panamá y su Decreto Ejecutivo 285 de 2021 (derechos ARCO); en España y el Espacio Económico Europeo, el RGPD. No se vende. Se conserva 12 meses desde su recepción y luego se elimina; escriba a privacidad@mail.atompty.com para conocerla, corregirla o eliminarla antes (derechos ARCO). Aviso completo: https://atompanama.com/privacidad\n\nOther ways in: MCP https://atompanama.com/mcp, A2A https://atompanama.com/.well-known/agent-card.json, guide https://atompanama.com/agents/.",
    "contact": {
      "name": "Atom Panamá",
      "url": "https://atompanama.com/agents/",
      "email": "hola@mail.atompty.com"
    }
  },
  "servers": [
    {
      "url": "https://atompanama.com"
    }
  ],
  "paths": {
    "/api/agent-inquiry": {
      "post": {
        "operationId": "submitInquiry",
        "summary": "Send an inquiry to Atom Panamá on behalf of a person",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "description": "Any unique string. A retry with the same key never records the inquiry twice."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "intent",
                  "need",
                  "contact",
                  "consent",
                  "on_behalf_of"
                ],
                "properties": {
                  "intent": {
                    "type": "string",
                    "enum": [
                      "request_quote",
                      "book_call",
                      "question",
                      "partnership",
                      "other"
                    ],
                    "description": "What the person wants: a quote, a call, an answer, a partnership, or other."
                  },
                  "need": {
                    "type": "string",
                    "minLength": 10,
                    "maxLength": 4000,
                    "description": "What the person needs, in their words: the problem, scope, roles or volumes."
                  },
                  "company": {
                    "type": "string",
                    "maxLength": 160,
                    "description": "The organization the person represents."
                  },
                  "contact": {
                    "type": "object",
                    "required": [
                      "name"
                    ],
                    "additionalProperties": false,
                    "description": "The person to answer. An email or a phone is required.",
                    "properties": {
                      "name": {
                        "type": "string",
                        "maxLength": 120
                      },
                      "role": {
                        "type": "string",
                        "maxLength": 160,
                        "description": "Job title or role."
                      },
                      "email": {
                        "type": "string",
                        "format": "email",
                        "maxLength": 200
                      },
                      "phone": {
                        "type": "string",
                        "maxLength": 32,
                        "description": "International format, e.g. +1 212 555 0100."
                      }
                    }
                  },
                  "budget": {
                    "type": "string",
                    "maxLength": 200,
                    "description": "Budget or range, free text (e.g. \"$20k-30k a month\")."
                  },
                  "timeline": {
                    "type": "string",
                    "maxLength": 200,
                    "description": "When they want to start or decide."
                  },
                  "language": {
                    "type": "string",
                    "enum": [
                      "en",
                      "es",
                      "pt"
                    ],
                    "description": "Language for the answer."
                  },
                  "consent": {
                    "type": "boolean",
                    "const": true,
                    "description": "True only if the person named in contact agreed to be contacted by this company about this inquiry."
                  },
                  "on_behalf_of": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "description": "Who the agent acts for: the person and, if any, their organization."
                  },
                  "agent": {
                    "type": "object",
                    "additionalProperties": false,
                    "description": "The agent sending this (optional but recommended). The User-Agent header is recorded too.",
                    "properties": {
                      "name": {
                        "type": "string",
                        "maxLength": 120
                      },
                      "url": {
                        "type": "string",
                        "format": "uri",
                        "maxLength": 300
                      },
                      "operator": {
                        "type": "string",
                        "maxLength": 160,
                        "description": "Who runs the agent."
                      }
                    }
                  },
                  "test": {
                    "type": "boolean",
                    "description": "True to test an integration: recorded and marked as a test, nobody follows up."
                  }
                }
              },
              "example": {
                "intent": "request_quote",
                "need": "Necesitamos un ingeniero senior para integrar nuestro ERP con la facturación electrónica.",
                "company": "Example Co",
                "contact": {
                  "name": "Sam Example",
                  "role": "Gerente de operaciones",
                  "email": "sam@example.com"
                },
                "budget": "US$8,000 al mes",
                "timeline": "Enero",
                "language": "es",
                "consent": true,
                "on_behalf_of": "Sam Example, Example Co",
                "agent": {
                  "name": "Example assistant",
                  "operator": "Example AI"
                },
                "test": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Already received (same Idempotency-Key or same inquiry today).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "received",
                        "duplicate"
                      ]
                    },
                    "inquiry_id": {
                      "type": "string"
                    },
                    "brand": {
                      "type": "string"
                    },
                    "automated": {
                      "type": "boolean",
                      "const": true
                    },
                    "from": {
                      "type": "string"
                    },
                    "received_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "test": {
                      "type": "boolean"
                    },
                    "message": {
                      "type": "string"
                    },
                    "next_steps": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "action": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string"
                          },
                          "minutes": {
                            "type": "integer"
                          }
                        }
                      }
                    },
                    "reply_by": {
                      "type": "string",
                      "enum": [
                        "email",
                        "phone"
                      ]
                    },
                    "privacy": {
                      "type": "string"
                    },
                    "warnings": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          },
          "201": {
            "description": "Received (automated acknowledgement).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "received",
                        "duplicate"
                      ]
                    },
                    "inquiry_id": {
                      "type": "string"
                    },
                    "brand": {
                      "type": "string"
                    },
                    "automated": {
                      "type": "boolean",
                      "const": true
                    },
                    "from": {
                      "type": "string"
                    },
                    "received_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "test": {
                      "type": "boolean"
                    },
                    "message": {
                      "type": "string"
                    },
                    "next_steps": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "action": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string"
                          },
                          "minutes": {
                            "type": "integer"
                          }
                        }
                      }
                    },
                    "reply_by": {
                      "type": "string",
                      "enum": [
                        "email",
                        "phone"
                      ]
                    },
                    "privacy": {
                      "type": "string"
                    },
                    "warnings": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid inquiry: errors lists each field and the problem.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "field": {
                            "type": "string"
                          },
                          "problem": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "retry_after_seconds": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "This brand takes no inquiries here.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "field": {
                            "type": "string"
                          },
                          "problem": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "retry_after_seconds": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Body larger than 16384 bytes.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "field": {
                            "type": "string"
                          },
                          "problem": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "retry_after_seconds": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "415": {
            "description": "Content-Type must be application/json.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "field": {
                            "type": "string"
                          },
                          "problem": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "retry_after_seconds": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate or daily limit; see Retry-After.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "field": {
                            "type": "string"
                          },
                          "problem": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "retry_after_seconds": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Not confirmed; retry with the same Idempotency-Key.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "field": {
                            "type": "string"
                          },
                          "problem": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "retry_after_seconds": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}