Free, Open Source, Self-Hosted WhatsApp API Gateway
TypeScript apibotgatewayself-hostedwhatsappwhatsapp-apiwhatsapp-automationwhatsapp-botwhatsapp-gatewaywhatsapp-gateway-apiwhatsapp-webwhatsapp-web-api
package openwa
import "context"
// StatusService posts and reads WhatsApp Status (Stories). This is distinct from
// session lifecycle status. Backed by src/modules/status/status.controller.ts.
type StatusService struct{ client *Client }
func (s *StatusService) base(sessionID string) string {
return "/api/sessions/" + pathEscape(sessionID) + "/status"
}
// List returns all status/stories visible to the session. The server returns
// {"statuses":[...]} — the envelope is unwrapped and only the slice is
// returned.
func (s *StatusService) List(ctx context.Context, sessionID string) ([]StatusRecord, error) {
var out StatusListResponse
err := s.client.do(ctx, "GET", s.base(sessionID), nil, nil, &out)
return out.Statuses, err
}
// FromContact returns the status/stories from a specific contact. Same
// {"statuses":[...]} envelope as List.
func (s *StatusService) FromContact(ctx context.Context, sessionID, contactID string) ([]StatusRecord, error) {
var out StatusListResponse
err := s.client.do(ctx, "GET", s.base(sessionID)+"/"+pathEscape(contactID), nil, nil, &out)
return out.Statuses, err
}
// Media fetches the stored media bytes for a status update. The server
// answers 404 when no media is stored (text status, omitted, or expired).
func (s *StatusService) Media(ctx context.Context, sessionID, statusID string) (*StatusMedia, error) {
data, contentType, err := s.client.doRaw(ctx, "GET", s.base(sessionID)+"/"+pathEscape(statusID)+"/media", nil, nil, false)
if err != nil {
return nil, err
}
return &StatusMedia{Data: data, ContentType: contentType}, nil
}
// SendText posts a text status.
func (s *StatusService) SendText(ctx context.Context, sessionID string, body SendTextStatusRequest) (*StatusResult, error) {
return s.send(ctx, sessionID, "/send-text", body)
}
// SendImage posts an image status.
func (s *StatusService) SendImage(ctx context.Context, sessionID string, body SendImageStatusRequest) (*StatusResult, error) {
return s.send(ctx, sessionID, "/send-image", body)
}
// SendVideo posts a video status.
func (s *StatusService) SendVideo(ctx context.Context, sessionID string, body SendVideoStatusRequest) (*StatusResult, error) {
return s.send(ctx, sessionID, "/send-video", body)
}
// SendVoice posts an audio status as a voice note. Requires an OPERATOR-level key.
func (s *StatusService) SendVoice(ctx context.Context, sessionID string, body SendVoiceStatusRequest) (*StatusResult, error) {
return s.send(ctx, sessionID, "/send-voice", body)
}
func (s *StatusService) send(ctx context.Context, sessionID, suffix string, body any) (*StatusResult, error) {
var out StatusResult
err := s.client.do(ctx, "POST", s.base(sessionID)+suffix, nil, body, &out)
if err != nil {
return nil, err
}
return &out, nil
}
// Delete removes a status post.
func (s *StatusService) Delete(ctx context.Context, sessionID, statusID string) error {
return s.client.do(ctx, "DELETE", s.base(sessionID)+"/"+pathEscape(statusID), nil, nil, nil)
}