Biolinks

Los biolinks son páginas de destino públicas de tipo link-in-bio. Cada página tiene un slug personalizado, un nombre visible y una biografía, un tema (predefinido o con colores personalizados), una lista de botones (enlaces, redes sociales, correo, teléfono, archivo, texto), una cuadrícula de publicaciones o galería, y analíticas de vistas y clics. Esta página documenta todos los comandos biolink: que expone la CLI.

Todos los comandos aceptan las opciones globales: --json (por defecto) / --table para el formato de salida, --verbose para errores detallados y --api-key <key> / --api-url <url> para sustituir las credenciales en cada llamada. Ninguno de los comandos biolink: acepta opciones de paginación.

Básicos

biolink:list

Lista todas las páginas de biolink de la organización autenticada.

so-me biolink:list

Ejemplo

so-me biolink:list --table

biolink:get

Obtiene todos los detalles de un biolink por su ID interno.

so-me biolink:get <id>

Ejemplo

so-me biolink:get 550e8400-e29b-41d4-a716-446655440000

biolink:public

Consulta los datos públicos de un biolink mediante su slug personalizado. Este comando resuelve la página igual que lo haría un visitante, por lo que no requiere el UUID interno.

so-me biolink:public <slug>

Ejemplo

so-me biolink:public my-brand-page

biolink:create

Crea una página de biolink nueva. Todas las opciones son opcionales.

so-me biolink:create [options]

Opción	Descripción
`--slug <slug>`	Slug de URL personalizado (3-50 caracteres alfanuméricos)
`--name <name>`	Nombre visible
`--bio <bio>`	Texto de la biografía

Ejemplo

so-me biolink:create --slug mypage --name "My Brand" --bio "Welcome to my page"

biolink:update

Actualiza una página de biolink. Indica al menos una opción o el comando termina con un error.

so-me biolink:update <id> [options]

Opción	Descripción
`--name <name>`	Nombre visible
`--bio <bio>`	Texto de la biografía
`--slug <slug>`	Slug personalizado
`--button-style <style>`	Estilo de botón: `rounded`, `square`, `pill`, `outline`
`--show-grid`	Muestra la cuadrícula de Instagram
`--hide-grid`	Oculta la cuadrícula de Instagram
`--social-icons <json>`	Iconos sociales como un arreglo JSON de objetos `{platform, url}`

--social-icons debe ser un arreglo JSON válido; un JSON no válido termina con un error antes de hacer ninguna solicitud. --show-grid y --hide-grid establecen la visibilidad de la cuadrícula de Instagram (pasa una, no ambas).

Ejemplos

# Rename and rewrite the bio
so-me biolink:update 550e8400-... --name "Acme Inc." --bio "Tools for makers"

# Switch button style and show the Instagram grid
so-me biolink:update 550e8400-... --button-style pill --show-grid

# Set social icons (escape the JSON for your shell)
so-me biolink:update 550e8400-... \
  --social-icons '[{"platform":"instagram","url":"https://instagram.com/acme"},{"platform":"x","url":"https://x.com/acme"}]'

biolink:delete

Elimina una página de biolink. Pide confirmación a menos que se pase -y/--yes.

so-me biolink:delete <id> [options]

Opción	Descripción
`-y, --yes`	Omite la confirmación

Ejemplo

so-me biolink:delete 550e8400-... --yes

biolink:publish

Alterna un biolink entre publicado y no publicado. El comando invierte el estado en que se encuentre la página y notifica el nuevo estado.

so-me biolink:publish <id>

Ejemplo

so-me biolink:publish 550e8400-...

Tema

biolink:theme

Cambia el tema de un biolink con un tema predefinido o con colores personalizados. Indica --preset, o una o más opciones de color personalizado; si no indicas ninguna, termina con un error. Si se indica --preset, tiene prioridad y las opciones de color personalizado se ignoran.

so-me biolink:theme <id> [options]

Opción	Descripción
`--preset <theme>`	Tema predefinido: `default`, `dark`, `gradient`, `minimal`, `neon`, `sunset`, `ocean`, `forest`
`--bg <color>`	Color de fondo personalizado (hexadecimal)
`--text <color>`	Color de texto personalizado (hexadecimal)
`--button <color>`	Color de botón personalizado (hexadecimal)
`--button-text <color>`	Color del texto del botón personalizado (hexadecimal)

Ejemplos

# Use a preset
so-me biolink:theme 550e8400-... --preset neon

# Custom colors
so-me biolink:theme 550e8400-... --bg "#1a1a2e" --text "#eaeaea" --button "#5417d7" --button-text "#ffffff"

Botones

biolink:buttons — Listar botones

Lista todos los botones de un biolink.

so-me biolink:buttons <biolink-id>

Ejemplo

so-me biolink:buttons 550e8400-... --table

biolink:add-button — Añadir un botón

Añade un botón a un biolink. --type y --text son obligatorias; el resto de opciones dependen del tipo de botón.

so-me biolink:add-button <biolink-id> --type <type> --text <text> [options]

Opción	Descripción
`--type <type>`	Tipo de botón: `link`, `social`, `email`, `phone`, `file`, `text` (obligatorio)
`--text <text>`	Texto del botón, máx. 100 caracteres (obligatorio)
`--url <url>`	URL (para el tipo `link`/`social`)
`--email <email>`	Correo electrónico (para el tipo `email`)
`--phone <phone>`	Teléfono (para el tipo `phone`)
`--file-url <url>`	URL del archivo (para el tipo `file`)
`--content <content>`	Contenido (para el tipo `text`)
`--icon <icon>`	Nombre del icono
`--color <hex>`	Color de botón personalizado (hexadecimal)

Ejemplos

# Link button
so-me biolink:add-button 550e8400-... --type link --text "Visit Website" --url https://example.com

# Social button with an icon and custom color
so-me biolink:add-button 550e8400-... --type social --text "Follow on X" \
  --url https://x.com/acme --icon x --color "#000000"

# Email button
so-me biolink:add-button 550e8400-... --type email --text "Contact us" --email [email protected]

biolink:update-button — Actualizar un botón

Actualiza un botón existente. Indica al menos una opción o el comando termina con un error.

so-me biolink:update-button <biolink-id> <button-id> [options]

Opción	Descripción
`--text <text>`	Texto del botón
`--url <url>`	URL
`--icon <icon>`	Icono
`--color <hex>`	Color personalizado
`--active`	Lo establece como activo
`--inactive`	Lo establece como inactivo

Ejemplo

so-me biolink:update-button 550e8400-... btn-123 --text "Shop now" --url https://example.com/shop --active

biolink:delete-button — Eliminar un botón

Elimina un botón. Pide confirmación a menos que se pase -y/--yes.

so-me biolink:delete-button <biolink-id> <button-id> [options]

Opción	Descripción
`-y, --yes`	Omite la confirmación

Ejemplo

so-me biolink:delete-button 550e8400-... btn-123 --yes

biolink:reorder-buttons — Reordenar botones

Reordena los botones de un biolink. Pasa los ID de los botones como argumentos posicionales en el orden de visualización deseado.

so-me biolink:reorder-buttons <biolink-id> <button-ids...>

Ejemplo

so-me biolink:reorder-buttons 550e8400-... btn-3 btn-1 btn-2

Galería

biolink:posts — Listar publicaciones de la galería

Lista las publicaciones o elementos de la galería de un biolink.

so-me biolink:posts <biolink-id>

Ejemplo

so-me biolink:posts 550e8400-... --table

biolink:add-post — Añadir una publicación a la galería

Añade una publicación a la galería. Todas las opciones son opcionales.

so-me biolink:add-post <biolink-id> [options]

Opción	Descripción
`--image <url>`	URL de la imagen
`--caption <text>`	Pie de foto
`--link <url>`	URL del enlace

Ejemplo

so-me biolink:add-post 550e8400-... \
  --image https://cdn.example.com/photo.jpg \
  --caption "Behind the scenes" \
  --link https://example.com/blog

biolink:update-post — Actualizar una publicación de la galería

Actualiza una publicación de la galería. Indica al menos una opción o el comando termina con un error.

so-me biolink:update-post <biolink-id> <post-id> [options]

Opción	Descripción
`--caption <text>`	Pie de foto
`--link <url>`	URL del enlace
`--visible`	La establece como visible
`--hidden`	La establece como oculta

Ejemplo

so-me biolink:update-post 550e8400-... post-123 --caption "Updated caption" --hidden

biolink:delete-post — Eliminar una publicación de la galería

Elimina una publicación de la galería. Pide confirmación a menos que se pase -y/--yes.

so-me biolink:delete-post <biolink-id> <post-id> [options]

Opción	Descripción
`-y, --yes`	Omite la confirmación

Ejemplo

so-me biolink:delete-post 550e8400-... post-123 --yes

biolink:reorder-posts — Reordenar publicaciones de la galería

Reordena las publicaciones de la galería. Pasa los ID de las publicaciones como argumentos posicionales en el orden de visualización deseado.

so-me biolink:reorder-posts <biolink-id> <post-ids...>

Ejemplo

so-me biolink:reorder-posts 550e8400-... post-3 post-1 post-2

Analíticas

biolink:analytics

Obtiene las analíticas de un biolink, incluidas las vistas, los clics y la tasa de clics (CTR).

so-me biolink:analytics <id>

Ejemplo

so-me biolink:analytics 550e8400-... --table

Primeros pasos

Publicación

AI Studio

Bandeja de entrada e interacción

Analíticas

Biolink

Equipo y colaboración

Configuración y facturación

Webhooks

Soporte

Básicos

biolink:list

biolink:get

biolink:public

biolink:create

biolink:update

biolink:delete

biolink:publish

Tema

biolink:theme

Botones

Galería

Analíticas

biolink:analytics

​Básicos

​biolink:list

​biolink:get

​biolink:public

​biolink:create

​biolink:update

​biolink:delete

​biolink:publish

​Tema

​biolink:theme

​Botones

​Galería

​Analíticas

​biolink:analytics

Básicos

biolink:list

biolink:get

biolink:public

biolink:create

biolink:update

biolink:delete

biolink:publish

Tema

biolink:theme

Botones

Galería

Analíticas

biolink:analytics