Firmantes

Las acciones de esta página sirven para quien entrega la invitación y el código de confirmación por su propio canal, como lo hace ChatISP en la conversación de WhatsApp. Si sus firmantes reciben todo por correo electrónico, Ravisign se encarga de eso por sí solo y usted no las necesita.

Todas exigen el alcance envelopes.escrever, porque dan acceso a la firma de otra persona.

En los ejemplos, la clave está en la variable de entorno RAVISIGN_CHAVE y las respuestas se acortaron donde se indica:

export RAVISIGN_CHAVE="rsg_..."
API="https://ravisign.com.br/api/v1"

signatarios/link#

GET, alcance envelopes.escrever. Parámetro signatario_uuid. Enlace de firma del firmante, para quien entrega la invitación por un canal propio (ChatISP lo envía en la conversación). El enlace es personal: no lo comparta con otra persona.

curl -sS -G "$API/signatarios/link" -H "Authorization: Bearer $RAVISIGN_CHAVE" \
  -d signatario_uuid=7eb90fca-1488-4a17-84c4-0b01f4acb9f1

{
    "ok": true,
    "signatario_uuid": "7eb90fca-1488-4a17-84c4-0b01f4acb9f1",
    "envelope_uuid": "157b650a-75e0-4eaa-a32c-b92b5a432ee4",
    "link": "https://ravisign.com.br/assinar.php?t=yEJ0y3ENQjLq3jTSy9Lx-obvgnQFa05o0mHtOP7C7m4",
    "situacao": "notificado",
    "envelope_situacao": "enviado"
}

Error 409 signatario_fora_da_vez cuando todavía no hay enlace (borrador, orden secuencial antes del turno u observador).

signatarios/otp_gerar#

POST, alcance envelopes.escrever. Solo para firmantes del canal conversa. Genera el código de confirmación de 6 dígitos (válido por 30 minutos) y lo devuelve para que el integrador lo entregue en la conversación. Parámetros signatario_uuid y, opcional, origem_conversa (objeto que identifica la conversación donde se entregará el código; va al registro de auditoría).

curl -sS "$API/signatarios/otp_gerar" -H "Authorization: Bearer $RAVISIGN_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"signatario_uuid":"7eb90fca-1488-4a17-84c4-0b01f4acb9f1","origem_conversa":{"conversa_id":"8812"}}'

{
    "ok": true,
    "signatario_uuid": "7eb90fca-1488-4a17-84c4-0b01f4acb9f1",
    "codigo": "473334",
    "canal": "conversa",
    "validade_minutos": 30,
    "expira_em": "2026-10-09T20:58:25-03:00"
}

• Un código nuevo invalida el anterior. Como máximo 4 códigos por hora para el mismo firmante (429 otp_reenvio_limite); cada código acepta 5 intentos.
• Errores: 409 canal_indisponivel (firmante de otro canal), 409 envelope_encerrado, envelope_vencido, situacao_invalida (ya firmó o rechazó) y signatario_fora_da_vez.

signatarios/otp_pendente#

GET, alcance envelopes.escrever. Parámetro signatario_uuid. El código del canal de conversación todavía válido (generado por la API o solicitado por el propio firmante en la página), para quien no usa webhook.

curl -sS -G "$API/signatarios/otp_pendente" -H "Authorization: Bearer $RAVISIGN_CHAVE" \
  -d signatario_uuid=7eb90fca-1488-4a17-84c4-0b01f4acb9f1

{
    "ok": true,
    "signatario_uuid": "7eb90fca-1488-4a17-84c4-0b01f4acb9f1",
    "pendente": true,
    "codigo": "473334",
    "expira_em": "2026-10-09T20:58:25-03:00",
    "segundos_restantes": 1800
}

Sin código válido: { "ok": true, "signatario_uuid": "...", "pendente": false }.

Atención el enlace y el código dan acceso a la firma del firmante. Entréguelos solo a la propia persona, no los registre en logs y no guarde el código después de entregarlo.